Gestion des Erreurs
Premiers Pas

Gestion des Erreurs

200 OK Requête réussie
400 Requête Incorrecte Paramètres invalides
401 Non Autorisé Clé API invalide ou manquante
402 Paiement Requis Crédits insuffisants
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 Trop de Requêtes Limite de débit dépassée
500 Erreur Serveur Erreur interne du serveur

Format de Réponse d'Erreur

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