Получение списка и состава пакетов для публикации на сайте провайдера
Список пакетов и каналов для вывода на сайт реализован в провайдерском API - https://provapi.24h.tv/v2/doc/provider#!/
Вход по логину и паролю от менеджера 24ТВ.
Для получения информации из API необходимо получить провайдерский токен из админ-панели https://24h.tv/admin/settings/tokens/
!!!: провайдерской токен не должен быть виден на сайте провайдера, с помощью токена возможно не только получать информацию, но и управлять абонентами и их подписками. Обязательно позаботьтесь, что бы данный токен не попал в третьи руки!
Пакеты бывают двух типов: базовые и дополнительные. В базовые пакеты входят основные телеканалы, а дополнительные пакеты являются расширением базовых. Каждый базовый пакет имеет свой список дополнительных пакетов, разрешённых для подключения вместе с ним. Так же базовый пакет может уже включать в себя какой-то перечень дополнительных пакетов (а может и не иметь таковых). Например, самый дешевый базовый пакет не имеет включенных доп. пакетов, но у него большой список доступных дополнительных пакетов, а в самый дорогой пакет напротив, уже включены некоторые дополнительные пакеты и поэтому список дополнительных пакетов, разрешённых для подключения с ним, небольшой. Дополнительные пакеты не имеют включённых или разрешённых дополнительных пакетов.
Вся информация выводится в json формате.
GET - запросы
Запрос иерахического списка пакетов
https://provapi.24h.tv/v2/packets
Для вывода информации о включенных каналах, включенных и доступных пакетов в параметрах запроса необходимо указать includes:
availables - дополнительные пакетые доступные для подключения с этим пакетом
includes - включенные дополнительные пакеты в пакет
channels - каналы в данном пакете
videos - все источники видео в данном пакете
Запрос плоского списка пакетов
https://provapi.24h.tv/v2/packets/flat
"base": true - базовый, false - дополнительный
"is_public": true - пакет доступен для подключения из приложения, false - не доступен (в архиве или бандл)
"design" - ссылки графику пакета
Структура
[
{
"id": 498,
"name": "Лайт+",
"row_slug": "lite",
"short": "210+ каналов",
"description": "210+ каналов",
"old_price": "0.00",
"price": "199.00",
"base": true,
"is_public": true,
"agreement": "",
"libraries": [],
"available": null,
"include": null,
"period": "0-1-0",
"period_human": {
"days": 0,
"months": 1,
"years": 0
},
"design": {
"background_tv": "http://cdn.media.24h.tv/1236x2160-лаит_WnUrPn0.jpg",
"background_mobile": "http://cdn.media.24h.tv/936х1764-лаит_rqScpE7.jpg",
"small_background_tv": "http://cdn.media.24h.tv/412х484х3_0002_L_2NhHihH_u824TmW_oIsCPgj.png",
"small_background_mobile": "http://cdn.media.24h.tv/351х472_0002_x3_l4SyzlD_FnG7L7i_3xkRNGf.png",
"big_background_tv": null,
"logo": null,
"mini_logo": null,
"corner_badge": null,
"inline_badge": null,
"special_features": null
},
"after_renew_packet_id": 498,
"is_bundle": false
},
Получение состава пакетов по id
При запросе конкретного пакета includes указывать не надо, вся информация уже включена в вывод.
https://povapi.24h.tv/v2/packets/{id пакета}
Структура включает ссылки на логотипы каналов
{
"id": 498,
"name": "Лайт+",
"row_slug": "lite",
"short": "210+ каналов",
"description": "210+ каналов",
"old_price": "0.00",
"price": "199.00",
"base": true,
"is_public": true,
"agreement": "",
"channels": [
{
"id": 731,
"parent_id": 3929,
"name": "Первый канал",
"slug": "pervyj-kanal-731",
"num": null,
"icon": "http://cdn.media.24h.tv/img/ch/80/72/8072c5f12dd4e27d0fb03158cb81048c.png",
"hd": false,
"is_hd": false,
"is_4k": false,
"archived_days": 0,
"cover": {
"bg": "http://cdn.media.24h.tv/img/ch/da/e3/dae3b855ab4ee3a08c0694f912dd38cb.png",
"color_bg": "http://cdn.media.24h.tv/img/ch/2b/84/2b845770ce7a8f7cc19d176007fdb1f3.png",
"light_bg": "http://cdn.media.24h.tv/img/ch/3f/20/3f20359a999c17c801d84ef20b8f3521.png",
"dark_bg": "http://cdn.media.24h.tv/img/ch/6d/bc/6dbc5ec941eb56aaf09ad6e728030f58.png",
"full": "http://cdn.media.24h.tv/img/ch/80/72/8072c5f12dd4e27d0fb03158cb81048c.png"
}
},
Получение списка категорий со списком каналов
https://provapi.24h.tv/v2/channels/categories
В приложении, меню “Телевидение” каналы отсортированы по категориям
[
{
"id": 0, -- Идентификатор категории
"name": "string", -- Название категории
"icon": "string", -- Иконка категории
"age": 0, -- Ограничение по возрасту
"images": [...] -- Список картинок для категории
"channels": [...] -- Список каналов включенных в категорию
},
...
]
Получение списка бесплатных каналов
https://provapi.24h.tv/v2/channels с фильтрацией по флагу is_free
"is_free": true,