Przewidywalne i łatwe do śledzenia awarie.

Konwencjonalne kody HTTP, jednolita treść i unikalny identyfikator dla każdego żądania.

Format błędu

403 application/json

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

Identyfikator żądania pojawia się w nagłówku i w formacie JSON. Wyślij tę kwotę do działu pomocy, aby zlokalizować połączenie.

Kody HTTP

200SukcesOperacja zakończona.

201UtworzonoUtworzono nową oczekującą ofertę.

400Nieprawidłowe żądanieNieprawidłowy JSON, parametr lub adres URL.

401NieuwierzytelnioneBrakujący, nieprawidłowy, wygasły lub unieważniony klucz.

402Wymagany planWymaga wersji Professional lub wyższej.

403Niewystarczający zakresKlucz nie ma wymaganego zakresu.

404Nie znalezionoNieistniejący punkt końcowy lub zasób.

413Bardzo duże ciałoRozmiar JSON przekroczył 128 KB.

429Limit przekroczonyKlucz przekroczył okno na minutę.

500Błąd wewnętrznyNieoczekiwana awaria; użyj identyfikatora żądania.

Limity i nagłówki

x-ratelimit-limitCałkowity limit okna

x-ratelimit-remainingPozostałe prośby

x-request-idIdentyfikator dzwoniącego

cache-controlprywatny, bez przechowywania danych uwierzytelnionych

120 req/min

Limit dotyczy jednego klucza. W przypadku 429 poczekaj na następne okno i użyj wycofywania z jitterem.

Lista kontrolna debugowania

Potwierdź bazę https://achadu.com/api/v1.

Zweryfikuj klucz za pomocą GET /me.

Sprawdź wymagany_zakres w 403 odpowiedziach.

Stan rekordu, identyfikator żądania i czas połączenia.

Nie powtarzaj automatycznie błędów 400, 401, 402 ani 403.

Porozmawiaj z pomocą techniczną →