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

JSON-обёртка

Примеры показывают обёртку, а не данные конкретного метода:

{"data": {}, "meta": {"request_id": "req_example"}}

{"error": {"code": "validation_error", "message": "Invalid request."}, "meta": {"request_id": "req_example"}}

В программной логике используйте error.code: текст сообщения может меняться. Серверный X-Request-ID совпадает с meta.request_id; сохраняйте его для диагностики.

Деньги и курсы — десятичные строки, кредиты — целые числа. Значение null зависит от поля и не всегда означает ноль.

Оплата и исключения

meta.billable сообщает о применении кредитной оплаты. Оплаченный ответ может содержать meta.credit.cost и remaining; при параллельных запросах остаток приблизителен. Итоги аккаунта в GET /me находятся в data.credit.

Тело выгрузки — сам документ; оплата указана в X-Billable, X-Credit-Cost, X-Credit-Remaining. Ответ 304 не содержит тела. Для проверки здоровья и других исключений смотрите схему операции.