docs
Документация
Всё для первого запроса, а затем полный справочник.
Первый запрос в три шага
- 1Создайте ключ в панели.
- 2Отправьте ссылку, которую нужно прочитать.
- 3Прочитайте JSON. Ключи есть всегда; отсутствующее значение — null.
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 только на английском и предназначен для логов, а не для ваших пользователей.
Заголовки ответа
Каждый успешный ответ содержит X-Credits-Charged, X-Credits-Remaining, X-Charge-Id и X-Request-Id, а также заголовки X-RateLimit-*. Повторный запрос с тем же Idempotency-Key возвращает Idempotent-Replay: true и не оплачивается. У каждого эндпоинта одна фиксированная цена за запрос.
Ограничение скорости
Запросы ограничены в секунду и растут вместе с купленными кредитами. При превышении приходит 429 с заголовком Retry-After.
Пагинация
Списочные эндпоинты возвращают не больше запрошенного размера страницы и meta.next_cursor. Передайте его как ?cursor=, чтобы получить следующую страницу; null значит, что записей больше нет.
Вебхуки и подпись
Каждая доставка содержит X-Timestamp и X-Signature = hex(HMAC-SHA256(secret, "<X-Timestamp>." + body)). Проверяйте подпись своим секретом и отклоняйте старые метки времени, чтобы защититься от повторов.