Получение списка и состава пакетов для публикации на сайте провайдера

Получение списка и состава пакетов для публикации на сайте провайдера

 

Список пакетов и каналов для вывода на сайт реализован в провайдерском 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,