Ошибки

Ошибки соответствуют RFC 9457 (Problem Details) и содержат стабильный код.

Формат

Content-Type application/problem+json с полями type, title, status, code, detail, instance (= X-Request-Id) и, при ошибках проверки, errors[] с path, message, code.

json

{
  "type": "https://www.claritos.io/developers/errors#validation-failed",
  "title": "Validation failed",
  "status": 422,
  "code": "validation-failed",
  "instance": "req_…",
  "errors": [
    { "path": "body.email", "message": "Invalid email", "code": "invalid_format" }
  ]
}

Коды

unauthorized (401), key-expired (401), ip-not-allowed (403), api-disabled (403), insufficient-scope (403), clients-data-not-enabled (403), not-found (404), method-not-allowed (405), conflict (409), payload-too-large (413), validation-failed (422), idempotency-mismatch (422), rate-limited (429), internal (500).

X-Request-Id

Каждый ответ содержит X-Request-Id. Указывайте его при обращении в поддержку — так мы найдём вызов в журнале.