Entwicklerdokumentation
Fehlercodes
Häufige API-Key- und Rate-Limit-Antworten der RivetAI REST API.
Fehlerformat
Fehler liefern einen JSON-Body mit einem top-level error-Objekt mit code, message und optionalem retry_after für Rate Limits.
Häufige Codes
| Code | Wann es auftritt |
|---|---|
| API_KEY_INVALID | Fehlerhafter Key, unbekanntes Präfix oder ungültiges Secret |
| API_KEY_REVOKED | Key wurde widerrufen. Neuen Key erstellen oder rotieren |
| API_KEY_EXPIRED | Key hat sein Ablaufdatum überschritten |
| API_KEY_SCOPE_REQUIRED | Route erfordert einen Scope, den der Key nicht deklariert |
| API_KEY_PROJECT_NOT_ELIGIBLE | Projekt ist nicht Studio-lizenziert oder hat keine Lizenz |
| API_KEY_INSUFFICIENT_SCOPE | Key fehlt ein erforderlicher Scope für diese Route |
| UNAUTHORIZED | Fehlender oder ungültiger Bearer-Token |
| FORBIDDEN | Authentifiziert, aber für diese Aktion nicht berechtigt |
| RATE_LIMITED | Zu viele Anfragen. Nach retry_after Sekunden erneut versuchen |