Obsługa błędów

Nasz interfejs API wykorzystuje standardowe kody statusu HTTP do komunikowania charakteru błędów. Kody te pomagają szybko zidentyfikować źródło problemu i podjąć działania naprawcze.

Błędy po stronie klienta (4xx)

• Zasada ogólna

  Każdy kod błędu zaczynający się od „4” wskazuje na problem z żądaniem po stronie klienta. Zazwyczaj oznacza to, że wystąpił błąd w sposobie skonstruowania lub wysłania zapytania.

• Szczegóły błędu

  Każda odpowiedź na błąd zawiera pole error dla opisu czytelnego dla człowieka oraz, w stosownych przypadkach, pole path wskazujące nieprawidłowy argument, aby poprowadzić Cię w kierunku rozwiązania.

Przykład

# Nieprawidłowy klucz API
{
    "error": "Invalid API key."
}

# Przekazywanie nieprawidłowego argumentu
{
    "error": "This value is not a valid currency.",
    "path":"base"
}

Błędy po stronie serwera (5xx)

• Zasada ogólna

  Kody błędów zaczynające się na „5” oznaczają problemy po stronie serwera. To są problemy po naszej stronie.

• Szczegóły błędu

  Ze względu na różnorodność tych błędów nie zawsze są łatwe do przewidzenia. Dołożymy jednak wszelkich starań, aby w polu „error” przedstawić czytelny dla człowieka opis problemu.

• HTTP 503 (usługa niedostępna)

  Może to nastąpić podczas zaplanowanej konserwacji.

Ograniczenie zapytań i błąd 429

• Przekroczenie limitu planu

  Jeśli przekroczysz limit planu, może pojawić się błąd HTTP 429. Oznacza to, że osiągnąłeś limit planu i będziesz tymczasowo zablokowany przed składaniem dalszych żądań.

• Tymczasowa blokada

  Ten błąd może również wskazywać na tymczasową blokadę, aby zapobiec nadużyciom.

• Nagłówek Retry-After

  Jeśli pojawi się ten błąd, sprawdź nagłówek Retry-After w odpowiedzi. Ten nagłówek wskaże liczbę sekund, które musisz poczekać przed złożeniem kolejnego żądania.