Ошибки

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

{
  "status": 401,
  "code": "API_KEY_EXPIRED",
  "message": "Срок действия ключа истёк. Создай новый ключ или подключи приложение заново.",
  "requestId": "0d2c6f3a-9b1e-4c7d-8a5f-3e2b1c0d9e8f"
}

• status — HTTP-статус ответа.
• code — машинный код. Если код тебе незнаком, ориентируйся на статус.
• message — текст по-русски для запасного показа; свой перевод делай по code.
• requestId — то же, что заголовок X-Request-ID; его можно прислать в поддержку.
• params — безопасные подробности некоторых кодов: scope, limitBytes, quotaBytes и usedBytes, retryAfter, feature.
• currentRevision — только у PASTE_REVISION_CONFLICT.

Когда повторять

• 429 и 503 с Retry-After — подожди указанное число секунд и повтори.
• 409 с Retry-After при загрузке — прошлая попытка ещё идёт; повтори с тем же Idempotency-Key.
• Сетевая ошибка при загрузке — повтори с тем же Idempotency-Key: дубля не будет.
• 401 API_KEY_EXPIRED и API_KEY_REVOKED — повтор не поможет, нужен новый ключ.

Общие для всех методов

Любой метод с ключом может ответить неверным или истёкшим ключом (401), нехваткой права (403 SCOPE_REQUIRED), ошибкой в полях (400), частыми запросами (429) или недоступностью сервиса (503). Страницы методов показывают только их собственные коды.

Коды