Files
main/docs/ru/api/get.md
2025-08-03 21:30:56 +03:00

4.0 KiB
Raw Blame History

Получить список воспроизведения

Расположение файла

/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
key string No Тип контента (прямой эфир, фильмы, радио_потоки, сериалы)
output string No Формат вывода (hls или m3u).
nocache boolean Нет

Пример запроса: ``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-адресу и стране, где это применимо.
- Для предотвращения чрезмерных запросов могут быть установлены ограничения на загрузку.