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

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