Перейти к содержимому

docs

Документация

Всё для первого запроса, а затем полный справочник.

Первый запрос в три шага

  1. 1Создайте ключ в панели.
  2. 2Отправьте ссылку, которую нужно прочитать.
  3. 3Прочитайте JSON. Ключи есть всегда; отсутствующее значение — null.
curl
curl -X POST https://app.qobilbek.dev/v1/media/extract \
  -H 'X-Api-Key: '"$API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.instagram.com/reel/DcMXl1IPNtB/"}'

Интерактивный справочник API

Каждый эндпоинт и поле с кнопкой «попробовать». Он генерируется с сервера, поэтому никогда не расходится с кодом.

Открыть справочник

Аутентификация

Аутентификация

Ключ передаётся в заголовке X-Api-Key. Полный ключ показывается один раз, при создании, — мы храним только его хеш. Никогда не кладите ключ во фронтенд-код.

Формат ответа

В каждом ответе есть ok. При успехе результат лежит в data, при ошибке — в error. code ошибки машинный и не меняется; message только на английском и предназначен для логов, а не для ваших пользователей.

"ok": true,
"video_id": "D2_IRvuenwg",
"format": "mp3",
"download_url": "https://…"
}
}
"ok": false,
"code": "insufficient_credits",
"message": "Not enough credits",
"request_id": "8e1924fff13b4217adbbc81e98eeee85"
}
}

Заголовки ответа

Каждый успешный ответ содержит X-Credits-Charged, X-Credits-Remaining, X-Charge-Id и X-Request-Id, а также заголовки X-RateLimit-*. Повторный запрос с тем же Idempotency-Key возвращает Idempotent-Replay: true и не оплачивается. У каждого эндпоинта одна фиксированная цена за запрос.

Ограничение скорости

Запросы ограничены в секунду и растут вместе с купленными кредитами. При превышении приходит 429 с заголовком Retry-After.

Вебхуки и подпись

Каждая доставка содержит X-Timestamp и X-Signature = hex(HMAC-SHA256(secret, "<X-Timestamp>." + body)). Проверяйте подпись своим секретом и отклоняйте старые метки времени, чтобы защититься от повторов.

Продукты · Цены