Перейти до змісту

Початок роботи

У цьому уроці ви надішлете перший підписаний запит до 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-статус: більшість помилок повертається зі статусом 200.

Результат Причина Що зробити
HTTP 400, "message": "You entered wrong sign key" Неправильний підпис або невідомий ключ Повторіть крок 1. Перевірте, що приватний ключ належить до тієї самої пари, що й публічний
HTTP 200, "result": "error" Неправильні параметри запиту Подивіться значення code у довіднику Content API
HTTP 429 Понад 1 000 запитів на хвилину з цим ключем Зменште кількість запитів

Наступні кроки

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