错误处理
入门指南

错误处理

200 正常 请求成功
400 错误请求 无效参数
401 未授权 无效或缺失的 API 密钥
402 需要付款 积分不足
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 请求过多 超过速率限制
500 服务器错误 内部服务器错误

错误响应格式

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