mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-28 03:03:18 +01:00
73 lines
4.0 KiB
Markdown
73 lines
4.0 KiB
Markdown
# Получить список воспроизведения
|
|
|
|
## Расположение файла
|
|
```
|
|
/home/xc_vm/wwwdir/get.php
|
|
```
|
|
|
|
## Обзор
|
|
Этот API предоставляет функции аутентификации и создания плейлистов. Клиенты могут аутентифицироваться, используя имя пользователя/пароль или токен. После успешной аутентификации генерируется плейлист.
|
|
|
|
## Аутентификация
|
|
Для аутентификации API требует либо имя пользователя и пароль, либо токен.
|
|
|
|
### Базовый URL
|
|
```
|
|
http://<ваш домен>:25461/get.php
|
|
```
|
|
|
|
## Конечные точки
|
|
|
|
### 1. Аутентификация и создание плейлиста
|
|
**Конечная точка:**
|
|
```
|
|
GET /
|
|
```
|
|
|
|
**Параметры запроса:**
|
|
|
|
| Параметр | Тип | Требуется | Описание |
|
|
|------------|----------|----------|-------------|
|
|
| username | string | Yes* | Имя пользователя для аутентификации (Обязательно, если не используется `token`). |
|
|
| password | string | Yes* | Пароль для аутентификации (требуется, если `token` не используется). |
|
|
| токен | строка | Да* | Токен аутентификации (требуется, если `имя пользователя` и `пароль` не используются). |
|
|
| | type | string | No | Тип устройства (по умолчанию: `m3u_plus`). |
|
|
| key | string | No | Тип контента (прямой эфир, фильмы, радио_потоки, сериалы)| |
|
|
| output | string | No | Формат вывода (hls или m3u). |
|
|
| | nocache | boolean | Нет | Если true, отключается кэширование. |
|
|
|
|
|
|
**Пример запроса:**
|
|
``sh
|
|
curl -X GET "http://<ваш-домен>:25461/get.php?username=test&password=test&type=m3u_plus&output=hls&key=live"
|
|
```
|
|
|
|
**Ответ:**
|
|
- Файл плейлиста.
|
|
|
|
## Коды ошибок
|
|
|
|
| Код ошибки | Описание |
|
|
|----------------------------|-------------|
|
|
| NO_CREDENTIALS | Отсутствуют данные аутентификации. |
|
|
| INVALID_CREDENTIALS | Неверное имя пользователя, пароль или токен. |
|
|
| BLOCKED_USER_AGENT | Агент пользователя заблокирован. |
|
|
| | EXPIRED | Срок действия учетной записи истек. |
|
|
| | DEVICE_NOT_ALLOWED | Тип устройства не разрешен. |
|
|
| | BANNED | Пользователь заблокирован. |
|
|
| | DISABLED | Учетная запись отключена. |
|
|
| | EMPTY_USER_AGENT | Агент пользователя необходим, но отсутствует. |
|
|
| | NOT_IN_ALLOWED_IPS | IP-адрес не разрешен. |
|
|
| | NOT_IN_ALLOWED_COUNTRY | Страна не разрешена. |
|
|
| | NOT_IN_ALLOWED_UAS | Агент пользователя не разрешен. |
|
|
| | ISP_BLOCKED | Провайдер заблокирован. |
|
|
| ASN_BLOCKED | Применено ограничение ASN. |
|
|
| | DOWNLOAD_LIMIT_REACHED | Слишком много запросов. |
|
|
| | GENERATE_PLAYLIST_FAILED | Не удалось сгенерировать список воспроизведения. |
|
|
|
|
## Примечания
|
|
- Убедитесь, что указаны правильные параметры запроса, чтобы избежать ошибок аутентификации.
|
|
- API применяет ограничения по агенту пользователя, IP-адресу и стране, где это применимо.
|
|
- Для предотвращения чрезмерных запросов могут быть установлены ограничения на загрузку.
|
|
|