Tratamento de Erros
Começar

Tratamento de Erros

200 OK Solicitação bem-sucedida
400 Solicitação Inválida Parâmetros inválidos
401 Não Autorizado Chave API inválida ou ausente
402 Pagamento Necessário Créditos insuficientes
403 Forbidden Fehlendes Abo (fetch-person), unbestätigte E-Mail-Adresse oder gesperrter Account.
404 Not Found Kein passendes Unternehmen gefunden — es werden keine Credits berechnet.
429 Muitas Solicitações Limite de taxa excedido
500 Erro do Servidor Erro interno do servidor

Formato de Resposta de Erro

Fehler kommen als JSON. Abrechnungsrelevante Fehler enthalten ein meta-Objekt; dessen Feld request_credit_cost zeigt immer, was tatsächlich berechnet wurde — bei fehlgeschlagenen Anfragen 0, mit Ausnahme des AI-Aufschlags:

402 — Nicht genügend Credits

{
  "meta": {
    "message": "Insufficient credits to perform this operation.",
    "request_credit_cost": 25,
    "credits_remaining": 3
  }
}

404 — Unternehmen nicht gefunden

{
  "detail": [
    {
      "type": "not_found",
      "loc": ["path", "q"],
      "msg": "Organization that matches 'Example GmbH' does not exist",
      "input": {"q": "Example GmbH"}
    }
  ],
  "meta": {
    "request_credit_cost": 0,
    "credits_remaining": 1250
  }
}

403 — Abo erforderlich (fetch-person)

{
  "error": "subscription_required",
  "meta": {
    "message": "fetch-person requires an active Plus, Pro, or Max subscription.",
    "required_plans": ["plus", "pro", "max"],
    "request_credit_cost": 0,
    "credits_remaining": 1250
  }
}

401 — Nicht autorisiert

{
  "error": "Unauthorized: Missing or invalid authentication. Please provide a valid API key (via x-api-key header or api_key parameter) or Bearer token."
}