Начало работы

Здесь показано, как отправить первый подписанный запрос в MEGOGO Content API. Пройдя все шаги, вы убедитесь, что ваши ключи работают, а код правильно вычисляет подпись.

Время: около 15 минут.

Подготовка

Вам понадобятся:

• Учетные данные от MEGOGO: ID партнера, публичный и приватный ключ для одной платформы. Подробнее — в разделе Учетные данные.
• Компьютер, с которого можно отправлять HTTPS-запросы. В примерах используются curl и Python 3.

ПРИМЕЧАНИЕ

Для первой проверки используйте тестовый ID партнера и тестовые ключи. Они работают на рабочих серверах: отдельной тестовой среды у MEGOGO нет.

Шаг 1. Вычислите подпись

Каждый запрос к Content API должен содержать параметр sign. Других параметров у этого запроса нет, поэтому подпись вычисляется так: возьмите MD5-хеш приватного ключа и допишите в конец публичный ключ.

from hashlib import md5

private_key = "{private_key}"
public_key = "{public_key}"

sign = md5(private_key.encode("utf-8")).hexdigest() + public_key
print(sign)

Получится 32-символьный шестнадцатеричный хеш, за которым следует ваш публичный ключ, например 781e5e245d69b566979b86e28d23f2c7_example1_xx.

Как подписать запрос с параметрами, описано в разделе Подпись запроса.

Шаг 2. Получите конфигурацию

Отправьте запрос с подписью, полученной на шаге 1:

curl "https://api.megogo.net/v1/configuration?sign={sign}"

Ожидаемый ответ (в сокращении):

{
  "result": "ok",
  "code": 200,
  "data": {
    "geo": "kz",
    "categories": [
      { "id": 16, "title": "Films" },
      { "id": 4, "title": "Series" }
    ],
    "free_vod_types": ["ADVOD", "FVOD"]
  }
}

• geo — страна, которую MEGOGO определил для вашего запроса.
• categories — категории контента. Их значения id передаются в запросах каталога.

Шаг 3. Проверьте результат

Проверьте поля result и code. Одного HTTP-статуса недостаточно: большинство ошибок возвращается с HTTP-статусом 200.

Результат	Причина	Что делать
HTTP 400, "message": "You entered wrong sign key"	Неправильная подпись или неизвестный ключ	Повторите шаг 1. Убедитесь, что приватный ключ взят из той же пары, что и публичный
HTTP 200, "result": "error"	Неправильные параметры запроса	Посмотрите значение code и найдите его в справочнике Content API
HTTP 429	С этим ключом отправлено больше 1 000 запросов в минуту	Уменьшите частоту запросов

Что дальше

• Пошагово: первое видео — весь путь от подписки до воспроизведения примерно за 30 минут.
• Подпись запроса с параметрами — с примерами кода на Python, JavaScript и PHP.
• Авторизация пользователя для воспроизведения платного контента.
• Создание и обновление каталога.

---

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