API-Referenz
Fehlerbehandlung
Standard-Fehlercodes, Rate-Limit-Header und Troubleshooting.
Zuletzt aktualisiert:
Fehlerbehandlung
Alle Fehlerantworten folgen einem konsistenten Format mit einem Fehlercode und einer für Menschen lesbaren Meldung:
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Fehlercodes
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Ungültige oder fehlende Anfrageparameter |
| 401 | UNAUTHORIZED | Fehlender oder ungültiger API-Schlüssel |
| 402 | PAYMENT_REQUIRED | Unzureichende Credits |
| 403 | FORBIDDEN | API-Zugang erfordert Business-Plan, oder Aktion nicht erlaubt |
| 403 | LIMIT_EXCEEDED | Plan-Limits erreicht (Projekte, Builds usw.) |
| 404 | NOT_FOUND | Ressource nicht gefunden oder nicht zugänglich |
| 409 | CONFLICT | Ressourcenkonflikt (Deployment läuft, Domain vergeben usw.) |
| 429 | RATE_LIMITED | Zu viele Anfragen — Rate-Limit-Header prüfen |
| 500 | INTERNAL_ERROR | Serverfehler — bitte erneut versuchen oder Support kontaktieren |
Rate-Limit-Header
Jede Antwort enthält diese Header:
X-RateLimit-Remaining— Anzahl der verbleibenden Anfragen im aktuellen FensterX-RateLimit-Reset— Sekunden bis zum Zurücksetzen des Rate-Limit-Fensters
Wenn Sie eine 429-Antwort erhalten, warten Sie die Anzahl der Sekunden, die durch X-RateLimit-Reset angegeben wird, bevor Sie es erneut versuchen.
Credit-Kosten
API-Aktionen, die Credits verbrauchen:
| Action | Credits |
|---|---|
| Projekt erstellen (initialer Build) | 5 |
| Verfeinerung | 1 |
| Code-Bearbeitung | 1 |
| Neu bereitstellen | 1 |
| Rollback | 1 |
| Klonen | 2 |
| Reaktivieren | 1 |
| Advisor-Frage | 1 |
Administratoren sind von Credit-Gebühren ausgenommen.
Fehlerbehebung
- 401 Unauthorized — Prüfen Sie, ob Ihr API-Schlüssel mit
flp_beginnt und als Bearer-Token angegeben ist - 403 Forbidden — Prüfen Sie, ob Ihr Konto ein aktives Business-Abonnement hat
- 409 Conflict on deploy — Warten Sie, bis das aktuelle Deployment abgeschlossen ist, oder brechen Sie es zuerst ab
- Subdomain-Fehler — Subdomains müssen kleingeschrieben sein, 3-63 Zeichen lang und dürfen nur Buchstaben, Zahlen und Bindestriche enthalten