From ffe54286f2601961540c722358392aa633def300 Mon Sep 17 00:00:00 2001 From: worldofiptvcom Date: Sat, 13 Dec 2025 10:40:13 +0300 Subject: [PATCH] Clean Swagger UI and add CORS warning alert - Removed lengthy documentation text from Swagger API page - Added prominent CORS error explanation to General Documentation - Users now understand "Try it out" failures are normal browser behavior - Provided alternative testing methods (cURL, Postman, code examples) --- index.html | 16 ++++++++ openapi.yaml | 103 +-------------------------------------------------- 2 files changed, 17 insertions(+), 102 deletions(-) diff --git a/index.html b/index.html index 548621f..03ec15e 100644 --- a/index.html +++ b/index.html @@ -497,6 +497,22 @@ Note: This documentation is for XUI.ONE v1.5.13+. Replace placeholder values with your actual credentials. +
+ ⚠️ + CORS Notice - "Try it out" Feature: When testing API endpoints directly in Swagger UI using the "Try it out" button, you may encounter a Failed to fetch error. This is NORMAL and EXPECTED browser behavior due to CORS (Cross-Origin Resource Security) policy. +

+ Why this happens: Your browser blocks requests from this documentation site (GitHub Pages) to your XUI.ONE server for security reasons. +

+ Solutions for testing: + + Important: This CORS error does NOT mean the documentation or API is broken. It's a browser security feature protecting your server. +
+

XUI.ONE Admin API Documentation

Comprehensive API documentation for XUI.ONE IPTV Panel Administration

diff --git a/openapi.yaml b/openapi.yaml index 4ec98c3..1469c55 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -1,108 +1,7 @@ openapi: 3.0.3 info: title: XUI.ONE Admin API - description: | - **Comprehensive API documentation for XUI.ONE IPTV Panel Administration** - - ### 🎯 Quick Start - - This API provides programmatic access to manage your IPTV platform with 180+ endpoints for: - - 📺 Manage subscriptions (Lines, MAG, Enigma2 devices) - - 🎬 Control streams, channels, movies, and series - - 📊 Monitor connections and activity logs - - ⚙️ Configure servers and load balancers - - --- - - ### 🔗 Base URL Pattern - - ``` - {protocol}://YOUR_SERVER:{port}//?api_key=&action=ACTION - ``` - - **Customize:** - - `{protocol}` → http or https - - `YOUR_SERVER` → Your server domain/IP (e.g., 192.168.1.100) - - `{port}` → Your port (80, 8000, 9000, or custom) - - `` → Your access code (e.g., `cSbuFLhp`) - - `` → Your API key - - `ACTION` → API action name (e.g., `get_lines`) - - **Common Ports:** - - `80` - HTTP (default) - - `8000` - HTTP (alternative) - - `9000` - HTTPS (recommended) - - Custom - Any port you configured - - --- - - ### 🔐 Authentication Setup - - **Required:** - 1. XUI.ONE panel installed (v1.5.5+) - 2. Admin API access code created - 3. API key generated from profile - - **Quick Setup:** - 1. Panel → Management → Access Control → Access Codes - 2. Create "Admin API" access code - 3. Profile → Generate API Key - 4. Test: `curl "http://your-server.com//?api_key=&action=user_info"` - - 📖 **[View detailed setup guide →](https://github.com/worldofiptvcom/xui-one-api-docs/blob/main/docs/getting-started.md)** - - --- - - ### 📝 Request Methods - - **GET** - Query data - ``` - /?api_key=&action=get_lines - ``` - - **POST** - Create/update data - ``` - curl -X POST ".../?api_key=&action=create_line" -d "username=test" - ``` - - --- - - ### ✅ Response Format - - **Success:** - ```json - { - "status": "STATUS_SUCCESS", - "data": { ... } - } - ``` - - **Error:** - ```json - { - "status": "STATUS_FAILURE", - "error": "Error description" - } - ``` - - --- - - ### 🔒 Security Best Practices - - - ✅ Use HTTPS (port 9000) in production - - ✅ Whitelist IPs in access code settings - - ✅ Rotate API keys regularly - - ✅ Never commit keys to version control - - --- - - ### 📚 Resources - - - **GitHub:** [Documentation Repository](https://github.com/worldofiptvcom/xui-one-api-docs) - - **Community:** [World of IPTV Forums](https://www.worldofiptv.com) - - **Getting Started:** [Setup Guide](https://github.com/worldofiptvcom/xui-one-api-docs/blob/main/docs/getting-started.md) - - **XUI.ONE:** [Official Website](https://xui.one) - + description: Comprehensive API documentation for XUI.ONE IPTV Panel Administration version: 1.5.13 contact: name: XUI.ONE API Support