Menu

Conceitos

Erros

Formato RFC 9457 e códigos estáveis.

Os erros seguem o padrão RFC 9457 (application/problem+json). O campo code é estável (use no seu código); detail explica em português.

{
  "type": "https://developers.converzap.com/pt/erros#forbidden_scope",
  "title": "Escopo insuficiente",
  "status": 403,
  "detail": "Esta chave não tem o escopo messages:send.",
  "code": "forbidden_scope",
  "request_id": "req_8f1c2a9b0d4e4c51a7b3"
}

Erros de validação trazem errors: [{campo, mensagem}]. Toda resposta tem o header X-Request-Id: informe-o ao suporte.

HTTPcode
400invalid_request
401unauthorized
401key_expired
401key_revoked
403ip_not_allowed
403forbidden_scope
403forbidden_role
403read_only
403trial_read_only
403plan_upgrade_required
403module_not_in_plan
402payment_required
402limit_reached
404not_found
409conflict
409idempotency_conflict
429rate_limited
502meta_error
500internal_error