Fehlercodes
Fehlercodes
Alle API-Fehler geben ein einheitliches JSON-Format zurück:
{
"error": "Not Found",
"message": "Resume not found",
"statusCode": 404
}HTTP-Statuscodes
| Code | Name | Beschreibung |
|---|---|---|
200 | OK | Anfrage erfolgreich |
201 | Created | Ressource erfolgreich erstellt |
400 | Bad Request | Ungültiger Anfragekörper oder Parameter |
401 | Unauthorized | Fehlender oder ungültiger API-Schlüssel |
402 | Payment Required | Keine Credits mehr vorhanden. Kaufen Sie weitere oder warten Sie auf den monatlichen Reset |
403 | Forbidden | Aktion nicht erlaubt (z. B. BYOK ohne Abonnement) |
404 | Not Found | Ressource existiert nicht |
413 | Payload Too Large | Datei-Upload überschreitet das 10-MB-Limit |
422 | Unprocessable Entity | Gültiges JSON, aber semantisch ungültig (z. B. Stellenbeschreibung zu kurz) |
429 | Too Many Requests | Rate Limit überschritten. Warten Sie den Wert des Retry-After-Headers ab |
500 | Internal Server Error | Ein Fehler auf unserer Seite |
Häufige Fehlerszenarien
Fehlender API-Schlüssel
{
"error": "Unauthorized",
"message": "Missing x-api-key header",
"statusCode": 401
}Lösung: Fügen Sie Ihren API-Schlüssel zum x-api-key-Header hinzu.
Ungültiger API-Schlüssel
{
"error": "Unauthorized",
"message": "Invalid API key",
"statusCode": 401
}Lösung: Überprüfen Sie Ihren Schlüssel unter console.laddro.com. Schlüssel könnten widerrufen worden sein.
Keine Credits
{
"error": "Payment Required",
"message": "No credits remaining. Purchase credits at console.laddro.com",
"statusCode": 402
}Lösung: Kaufen Sie ein Credit-Paket oder warten Sie auf den monatlichen Reset der kostenlosen Stufe.
BYOK ohne aktives Abonnement
{
"error": "Forbidden",
"message": "BYOK requires an active recurring Laddro subscription",
"statusCode": 403
}Lösung: Abonnieren Sie unter laddro.com mit einem wiederkehrenden Plan.
Ungültiger Anbieter-Schlüssel
{
"error": "Unprocessable Entity",
"message": "API key validation failed for provider 'anthropic': invalid_api_key",
"statusCode": 422
}Lösung: Überprüfen Sie Ihren Anbieter-API-Schlüssel. Die API validiert Schlüssel mit einem Testaufruf, bevor sie gespeichert werden.
Wiederholungsstrategie
Für 429- und 5xx-Fehler implementieren Sie exponentiellen Backoff:
async function withRetry(fn: () => Promise<Response>, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
const response = await fn()
if (response.status === 429) {
const retryAfter = parseInt(response.headers.get('Retry-After') || '1')
await new Promise(r => setTimeout(r, retryAfter * 1000))
continue
}
return response
} catch (error) {
if (i === maxRetries - 1) throw error
await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000))
}
}
}