Vorhersehbare und leicht zu verfolgende Fehler.

Konventionelle HTTP-Codes, einheitlicher Text und eindeutige Kennung für jede Anfrage.

Fehlerformat

403 application/json

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

Die request_id erscheint im Header und im JSON. Senden Sie diesen Betrag an den Support, um einen Anruf zu tätigen.

HTTP-Codes

200ErfolgVorgang abgeschlossen.

201ErstelltNeues ausstehendes Angebot erstellt.

400Ungültige AnfrageUngültiger JSON, Parameter oder URL.

401Not authenticatedFehlender, ungültiger, abgelaufener oder widerrufener Schlüssel.

402Plan requiredErfordert Professional oder höher.

403Unzureichender UmfangDer Schlüssel hat nicht den erforderlichen Umfang.

404Nicht gefundenNicht vorhandener Endpunkt oder Ressource.

413Sehr großer KörperDer JSON hat 128 KB überschritten.

429Grenzwert überschrittenDer Schlüssel hat das Zeitfenster pro Minute überschritten.

500Interner FehlerUnerwarteter Fehler; Verwenden Sie request_id.

Limits und Header

x-ratelimit-limitGesamtfensterlimit

x-ratelimit-remainingVerbleibende Anfragen

x-request-idAnrufer-ID

cache-controlprivat, keine Speicherung authentifizierter Daten

120 req/min

Das Limit gilt pro Schlüssel. Warten Sie bei 429 auf das nächste Fenster und verwenden Sie Backoff mit Jitter.

Debug-Checkliste

Bestätigen Sie die Basis https://achadu.com/api/v1.

Validieren Sie den Schlüssel mit GET /me.

Überprüfen Sie „required_scope“ in 403-Antworten.

Zeichnen Sie Status, Anfrage-ID und Anrufzeit auf.

Wiederholen Sie die Fehler 400, 401, 402 oder 403 nicht automatisch.

Sprechen Sie mit dem technischen Support →