Voorspelbare en eenvoudig te traceren fouten.

Conventionele HTTP-codes, uniforme body en unieke identificatie voor elk verzoek.

Foutformaat

403 application/json

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

De request_id verschijnt in de header en in de JSON. Stuur dit bedrag naar ondersteuning om een oproep te lokaliseren.

HTTP-codes

200SuccesOperatie voltooid.

201GemaaktNieuwe lopende aanbieding gemaakt.

400Ongeldig verzoekOngeldige JSON, parameter of URL.

401Niet geauthenticeerdOntbrekende, ongeldige, verlopen of ingetrokken sleutel.

402Plan vereistVereist Professional of hoger.

403Onvoldoende reikwijdteDe sleutel heeft niet het vereiste bereik.

404Niet gevondenNiet-bestaand eindpunt of resource.

413Zeer groot lichaamDe JSON is groter dan 128 KB.

429Limiet overschredenDe sleutel heeft het per minuut-venster overschreden.

500Interne foutOnverwachte mislukking; gebruik request_id.

Limieten en headers

x-ratelimit-limitTotale raamlimiet

x-ratelimit-remainingResterende verzoeken

x-request-idBeller-ID

cache-controlprivé, geen opslag van geverifieerde gegevens

120 req/min

De limiet geldt per sleutel. Wacht voor 429 op het volgende venster en gebruik backoff met jitter.

Controlelijst voor foutopsporing

Bevestig de basis https://achadu.com/api/v1.

Valideer de sleutel met GET /me.

Controleer require_scope in 403 reacties.

Registreer status, request_id en beltijd.

Herhaal 400-, 401-, 402- of 403-fouten niet automatisch.

Praat met technische ondersteuning →