Felhantering
Komma igång

Felhantering

200 OK Förfrågan lyckades
400 Felaktig förfrågan Ogiltiga parametrar
401 Obehörig Ogiltig eller saknad API-nyckel
402 Betalning krävs Otillräckliga krediter
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 För många förfrågningar Hastighetsgräns överskriden
500 Serverfel Internt serverfel

Felsvarformat

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."
}