Guasti prevedibili e facili da monitorare.

Codici HTTP convenzionali, corpo uniforme e identificatore univoco per ogni richiesta.

Formato errore

403 application/json

{
  "error": {
    "code": "insufficient_scope",
    "message": "esta chave precisa do escopo commissions:read",
    "required_scope": "commissions:read"
  },
  "request_id": "req_01J..."
}

Il request_id viene visualizzato nell'intestazione e nel JSON. Invia questo importo all'assistenza per individuare una chiamata.

Codici HTTP

200SuccessoOperazione completata.

201CreatoNuova offerta in sospeso creata.

400Richiesta non validaJSON, parametro o URL non valido.

401Non autenticatoChiave mancante, non valida, scaduta o revocata.

402È necessario un pianoRichiede Professional o superiore.

403Portata insufficienteLa chiave non ha l'ambito richiesto.

404Non trovatoEndpoint o risorsa inesistente.

413Corpo molto grandeIl JSON ha superato i 128 KB.

429Limite superatoLa chiave ha superato la finestra al minuto.

500Errore internoGuasto imprevisto; utilizzare request_id.

Limiti e intestazioni

x-ratelimit-limitLimite totale della finestra

x-ratelimit-remainingRichieste rimanenti

x-request-idID chiamante

cache-controlprivato, senza memorizzazione di dati autenticati

120 req/min

Il limite è per chiave. Per 429, attendere la finestra successiva e utilizzare il backoff con jitter.

Elenco di controllo del debug

Conferma la base https://achadu.com/api/v1.

Convalidare la chiave con GET /me.

Controlla require_scope nelle risposte 403.

Stato del record, request_id e ora della chiamata.

Non ripetere automaticamente gli errori 400, 401, 402 o 403.

Parla con il supporto tecnico →