Riferimento API
Gestione degli Errori
Codici di errore standard, header di rate-limit e troubleshooting.
Ultimo aggiornamento:
Gestione degli errori
Tutte le risposte di errore seguono un formato coerente con un codice di errore e un messaggio leggibile dall'utente:
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Codici di errore
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Parametri di richiesta non validi o mancanti |
| 401 | UNAUTHORIZED | Chiave API mancante o non valida |
| 402 | PAYMENT_REQUIRED | Crediti insufficienti |
| 403 | FORBIDDEN | L'accesso all'API richiede il piano Business, oppure l'azione non è consentita |
| 403 | LIMIT_EXCEEDED | Limiti del piano raggiunti (progetti, build, ecc.) |
| 404 | NOT_FOUND | Risorsa non trovata o non accessibile |
| 409 | CONFLICT | Conflitto di risorse (deployment in corso, dominio già preso, ecc.) |
| 429 | RATE_LIMITED | Troppe richieste — controlla gli header del limite di velocità |
| 500 | INTERNAL_ERROR | Errore del server — riprova o contatta il supporto |
Header del limite di velocità
Ogni risposta include questi header:
X-RateLimit-Remaining— Numero di richieste rimanenti nella finestra correnteX-RateLimit-Reset— Secondi fino al reset della finestra del limite di velocità
Quando ricevi una risposta 429, attendi il numero di secondi indicato da X-RateLimit-Reset prima di riprovare.
Costi in crediti
Azioni API che consumano crediti:
| Action | Credits |
|---|---|
| Creazione progetto (build iniziale) | 5 |
| Raffinamento | 1 |
| Modifica codice | 1 |
| Ridistribuzione | 1 |
| Rollback | 1 |
| Clone | 2 |
| Riattivazione | 1 |
| Domanda all'Advisor | 1 |
Gli amministratori sono esenti dai costi in crediti.
Risoluzione dei problemi
- 401 Unauthorized — Verifica che la tua chiave API inizi con
flp_e sia inclusa come Bearer token - 403 Forbidden — Verifica che il tuo account abbia un abbonamento Business attivo
- 409 Conflict on deploy — Attendi che il deployment corrente sia completato o annullalo prima
- Errori sottodominio — I sottodomini devono essere in minuscolo, da 3 a 63 caratteri, e contenere solo lettere, numeri e trattini