API-Referentie
Foutafhandeling
Standaard foutcodes, rate-limit-headers en troubleshooting.
Laatst bijgewerkt:
Foutafhandeling
Alle foutresponses volgen een consistent formaat met een foutcode en een voor mensen leesbaar bericht:
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Foutcodes
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Ongeldige of ontbrekende verzoekparameters |
| 401 | UNAUTHORIZED | Ontbrekende of ongeldige API-sleutel |
| 402 | PAYMENT_REQUIRED | Onvoldoende credits |
| 403 | FORBIDDEN | API-toegang vereist het Business-plan, of actie niet toegestaan |
| 403 | LIMIT_EXCEEDED | Planlimietens bereikt (projecten, builds, enz.) |
| 404 | NOT_FOUND | Resource niet gevonden of niet toegankelijk |
| 409 | CONFLICT | Resourceconflict (deployment in uitvoering, domein bezet, enz.) |
| 429 | RATE_LIMITED | Te veel verzoeken — controleer de rate-limit-headers |
| 500 | INTERNAL_ERROR | Serverfout — probeer opnieuw of neem contact op met support |
Rate-limit-headers
Elke response bevat deze headers:
X-RateLimit-Remaining— Aantal resterende verzoeken in het huidige vensterX-RateLimit-Reset— Seconden tot het rate-limit-venster wordt gereset
Wanneer je een 429-response ontvangt, wacht je het aantal seconden dat wordt aangegeven door X-RateLimit-Reset voordat je het opnieuw probeert.
Creditkosten
API-acties die credits verbruiken:
| Action | Credits |
|---|---|
| Project aanmaken (initiële build) | 5 |
| Verfijning | 1 |
| Code-bewerking | 1 |
| Redeploy | 1 |
| Rollback | 1 |
| Klonen | 2 |
| Reactiveren | 1 |
| Advisorvraag | 1 |
Beheerders zijn vrijgesteld van creditkosten.
Probleemoplossing
- 401 Unauthorized — Controleer of je API-sleutel begint met
flp_en is opgenomen als Bearer-token - 403 Forbidden — Controleer of je account een actief Business-abonnement heeft
- 409 Conflict bij deploy — Wacht tot de huidige deployment is voltooid, of annuleer hem eerst
- Subdomeinsfouten — Subdomeinen moeten kleine letters zijn, 3-63 tekens, en mogen alleen letters, cijfers en koppeltekens bevatten