Учетные данные¶

Перед началом интеграции MEGOGO выдает вам набор ID и ключей. Ниже описано, для чего нужно каждое значение и как его защитить.

Что вы получаете от MEGOGO¶

Значение	Пример	Где используется	Назначение
ID партнера	`{partner_id}`	Billing API (путь), `/auth/by_partners` (`partner_key`)	Идентифицирует вашу компанию
Публичный ключ	`{public_key}`	Content API (`sign`)	Идентифицирует пару ключей; добавляется в конец каждой подписи
Приватный ключ	`{private_key}`	Content API (`sign`)	Нужен для вычисления подписи. Никогда не передавайте его в запросе
Соль (salt)	`{salt}`	Токен авторизации	Нужна для вычисления токена авторизации пользователя
ID услуг	`{service_id}`	Billing API (`serviceId`)	Идентифицируют подписки и покупки, которые вы продаете
Тестовый ID партнера и тестовые ключи	`testprod_ua`	Все запросы	Тестирование на рабочих серверах

Все эти значения формирует MEGOGO, изменить их нельзя.

Ключи для платформ¶

Для каждой платформы MEGOGO выдает отдельную пару ключей (публичный и приватный):

веб
мобильные устройства
Smart TV
приставки (STB)

Набор доступного контента для разных ключей может различаться. Используйте ключ той платформы, на которой пользователь смотрит видео.

Кроме того, для каждого ключа MEGOGO задает настройки потока:

Настройка	Варианты
Протокол потоковой передачи для видео без DRM	HLS, DASH или MSS
Система DRM и протокол для видео с DRM	Widevine (DASH), PlayReady (DASH или MSS), FairPlay (HLS)
Видео 4K (UHD)	Отдельная настройка с H.265: HLS или DASH без DRM, Widevine (DASH), PlayReady (DASH), FairPlay (HLS). Если настройка не задана, видео 4K по этому ключу не воспроизводятся

Сообщите своему менеджеру MEGOGO, какие протоколы и системы DRM поддерживает ваш плеер на каждой платформе. Протокол потока возвращается в поле stream_type ответа /stream: hls, dash или mss.

ID услуг¶

Подписки (SVOD): MEGOGO выдает текстовые ID, например premiumsvod. Обычно период подписки — 30 дней. Для пробного доступа, например на 7 или 14 дней, MEGOGO может выдать отдельные ID услуг.
Разовые покупки (TVOD, DTO): ID услуги — число, а именно tariff_id, который Content API возвращает для видео в purchase_info. ID и цены из XML-фида для этого не используйте.

Тестовый ID партнера¶

Отдельной тестовой среды у MEGOGO нет. Тестовый ID партнера (например, testprod_ua или testprod_az) и тестовые ключи работают на рабочих серверах — используйте их для всех проверок.

IP-адреса для Billing API¶

Billing API принимает запросы только с IP-адресов ваших серверов.

Передайте список своих IP-адресов менеджеру MEGOGO.
Чтобы изменить список, напишите на supportpartners@megogo.net и укажите в письме свой ID партнера.

На запрос с IP-адреса, которого нет в списке, возвращается HTTP 401 с текстовым сообщением (не в формате JSON).

Защита учетных данных¶

ВНИМАНИЕ

Храните соль только на своем сервере и не включайте ее в клиентское приложение. Зная соль и приватный ключ, можно авторизоваться от имени любого вашего пользователя.

ВНИМАНИЕ

Храните приватные ключи на своем сервере. Если запросы к Content API отправляет клиентское приложение, пусть оно получает подписанный URL от вашего сервера. Тогда запрос уходит с клиента, и MEGOGO определяет местоположение пользователя по IP-адресу клиента.

ВНИМАНИЕ

Не размещайте учетные данные в репозитории, журналах и сообщениях об ошибках. Если учетные данные попали к постороннему, немедленно сообщите об этом своему менеджеру MEGOGO.

Лимиты¶

С каждого ключа можно отправлять в Content API до 1 000 запросов в минуту. Такой же лимит действует для Billing API. При превышении лимита MEGOGO может вернуть HTTP 429 Too Many Requests. Чтобы увеличить лимит, обратитесь к своему менеджеру MEGOGO.

Что дальше¶

Подпись запроса
Начало работы: отправьте первый запрос

Версия руководства 1.4.1, 2026-10-31 · Сообщить о проблеме на этой странице