Ошибки — LegalStack

Формат ошибок Problem Details (RFC 9457) и каталог кодов.

API возвращает ошибки в формате RFC 9457 Problem Details с Content-Type: application/problem+json:

{
  "type": "https://legalstack.ru/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "code": "VALIDATION_FAILED",
  "errors": [{ "pointer": "/email", "name": "email", "reason": "Invalid email" }],
  "instance": "/api/v1/security/users",
  "request_id": "req_01hzx..."
}

Как читать ответ:

code — стабильный машиночитаемый идентификатор; ветвите обработку по нему, а не по тексту.
type — URL вида https://legalstack.ru/errors/<код-в-kebab-case>, ведёт на описание ошибки в этой документации.
errors — для ошибок валидации: список полей с JSON Pointer и причиной.
request_id / trace_id — идентификаторы для обращения в поддержку.
При 429 и 503 дополнительно приходит заголовок Retry-After.

Полный перечень кодов — в каталоге ошибок.