Tratarea erorilor
Primii pași

Tratarea erorilor

200 OK Cerere reușită
400 Cerere greșită Parametri invalizi
401 Neautorizat Cheie API invalidă sau lipsă
402 Plată necesară Credite insuficiente
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 Prea multe cereri Limita de viteză depășită
500 Eroare server Eroare internă de server

Format răspuns eroare

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