Часто задаваемые вопросы

Это удобный редактор плейлистов в формате m3u и m3u8. Вы можете создавать новые плейлисты, изменять свои уже готовые плейлисты без бесконечного по всему интернету информации о атрибутах, тегах и других опциях плейлистов и их значении и применении. Всё уже есть в редакторе.

API позволяет управлять абонентами плейлистов — создавать, удалять, приостанавливать и восстанавливать ссылки, а также получать сведения о подписчиках. Управление доступно программно через HTTP-запросы без использования веб-интерфейса.

Для использования API необходимо выполнить три условия:

• Активная подписка «Плюс» на вашем аккаунте.

• Сгенерированный API-токен — создаётся в личном кабинете на странице «Профиль», в блоке «API Токен».

• Плейлист, абонентами которого вы хотите управлять, должен существовать в вашем аккаунте.

⚠ Токен показывается только один раз при создании. Если вы его не сохранили или он был утерян или скомпрометирован, восстановить его невозможно. При необходимости сгенерируйте новый (старый при этом удаляется и становится недействительным).

Для получения API-токена необходимо:

1.    Перейдите в Профиль → блок «API Токен».
2.    Введите название токена (например: «Мой сервер») или оставьте поле пустым — будет использовано автоматическое название.
3.    Нажмите «Создать токен». Токен отобразится в жёлтой рамке с предупреждением.
4.    Скопируйте токен и сохраните в надёжном месте. После закрытия страницы он больше не будет доступен.

Параметры XML-запроса.

     Все запросы к API имеют одинаковую структуру XML-тела:

<?xml version="1.0" encoding="UTF-8"?>

<request>

<action>...</action>

<playlist_name>...</playlist_name>

<sub_name>...</sub_name>

<link_format>...</link_format>

<file_format>...</file_format>

<expires_at>...</expires_at>

</request>

Параметр	Тип	Обязателен	Описание
action	string	Всегда	Действие: add, delete, hold, activate, regenerate, list
playlist_name	string	Всегда	Точное название плейлиста в вашем аккаунте
sub_name	string	Всегда	Имя абонента или all (для массовых операций)
link_format	string	Только для add	Протокол ссылок: http или https
file_format	string	Только для add	Формат файла плейлиста: m3u или m3u8
expires_at	string	Нет (опционально)	Дата истечения в ISO 8601. Пример: 2026-12-31T23:59:59Z. По умолчанию: +3 месяца

Пример использования API для создания нового абонента:

curl -X POST https://m3ulist.app/api/v1/clients \

     -H "Authorization: Bearer tk_ВАШ_ТОКЕН" \

     -H "Content-Type: application/xml" \

     -d '<?xml version="1.0" encoding="UTF-8"?>

<request>

   <action>add</action>

   <playlist_name>My Fav IPTV</playlist_name>

   <sub_name>premium_pack</sub_name>

   <link_format>https</link_format>

   <file_format>m3u8</file_format>

   <expires_at>2026-12-31T23:59:59Z</expires_at>

</request>'

Пример ответа сервера при успешном создании абонента:

<?xml version="1.0" encoding="UTF-8"?>

<response>

   <status>success</status>

   <action>add</action>

   <data>

      <playlist_name>My Fav IPTV</playlist_name>

      <sub_name>premium_pack</sub_name>

      <status>active</status>

      <expires_at>2026-12-31T23:59:59+00:00</expires_at>

      <full_link>https://m3ulist.app/dl/abc123...xyz.m3u8</full_link>

      <short_link_1>https://m3ulist.app/dl/Ab3cD4eF</short_link_1>

      <short_link_2>https://m3ulist.app/dl/Ab3cD4eF.m3u8</short_link_2>

    </data>

</response>

Справка о доступных аргументах для атрибута <action>:

add — Добавить абонента. Создаёт нового абонента в плейлисте и генерирует файл плейлиста с тремя ссылками: длинной (полный токен) и двумя короткими (без расширения и с расширением).

delete — Удалить абонента. Безвозвратно удаляет абонента, все его ссылки и сгенерированные файлы. При sub_name=all удаляет всех абонентов плейлиста.

hold — Приостановить доступ. Деактивирует ссылки абонента. Абонент остаётся в базе, но его ссылки перестают работать (возвращают 404).

activate — Активировать доступ. Возобновляет работу ранее приостановленных ссылок абонента.

list — Получить информацию. Возвращает данные о конкретном абоненте или список всех абонентов плейлиста.

regenerate — Перегенерировать ссылки. Пересоздаёт абонентские ссылки . Токены и ссылки меняются. Обратите внимание: старые ссылки удаляются и перестают работать!

Таблица атрибутов для которых возможны массовые операции:

action	Поддерживает all	Что происходит
delete	Да	Удаляет всех абонентов, возвращает список удалённых
hold	Да	Деактивирует всех, возвращает список приостановленных
activate	Да	Активирует всех, возвращает список активированных
regenerate	Да	Перегенерирует ссылки для всех абонентов в плейлисте
list	Да	Возвращает массив subscriptions со всеми абонентами
add	Нет	Ошибка: sub_name=all недопустимо для add