Errori API e paginazione
Quando una richiesta fallisce, controlla lo stato HTTP e il corpo della risposta. Mantieni il corpo privato se contiene dati dell’account, del codice sorgente o dell’applicazione.
Codici di stato
| Stato | Cosa controllare |
|---|---|
| 400 | Campi obbligatori, codifica del corpo, ID delle risorse, valori della query e X-Tenant-ID. |
| 401 | Token mancante, scaduto o incompatibile. Ottieni un nuovo token diagnostico quando necessario. |
| 402 | L'abbonamento del team o il diritto alle risorse per l'operazione. |
| 403 | Appartenenza al team, ruolo, autorizzazioni della risorsa e corrispondenza tra token e team. |
| 404 | ID della risorsa, team attivo e route. |
| 409 | Stato della risorsa in conflitto o operazione già in corso. |
| 429 | Attendi prima di riprovare e rispetta Retry-After quando presente. |
| 5xx | Disponibilità del servizio. Conserva l’ora, la route e una risposta priva di dati sensibili per diagnosticare il problema. |
Le operazioni riuscite restituiscono uno stato 2xx. Le eliminazioni CRUD generate usano HTTP 200 con un messaggio, mentre le eliminazioni di oggetti documentate usano 204. Segui le specifiche di ogni endpoint senza presumere un unico stato di successo per tutti i metodi.
Paginazione degli elenchi
Le liste CRUD generate accettano:
| Parametro | Predefinito | Limite |
|---|---|---|
page | 1 | Usa le informazioni di paginazione restituite per richiedere altre pagine. |
per_page | 20 | Massimo 100. |
Restituiscono i record in data e metadati in pagination. Gli endpoint personalizzati possono usare formati di elenco o cursori diversi; consulta i parametri e le specifiche della risposta. Copia gli ID dai dati restituiti per le operazioni successive.
Nuovi tentativi e attività asincrone
Dopo un errore temporaneo, ripeti le letture con un ritardo limitato. Prima di ripetere una creazione, distribuzione, attivazione di workflow, caricamento o altra modifica, controlla lo stato della destinazione per capire se il primo tentativo ha già avuto effetto. Questa documentazione pubblica non garantisce un meccanismo universale di chiavi di idempotenza.
Una richiesta riuscita di compilazione, distribuzione, anteprima o comando può avviare un’attività che termina in seguito. Leggi lo stato e i log prima di considerarla completata. Vedi verifica della distribuzione e log e metriche.