Pierwsze kroki

Błędy

Obsługuj błędy według statusu HTTP i nigdy nie ponawiaj bezrefleksyjnie każdego nieudanego żądania. Zawsze wysyłaj Accept: application/json.

StatusCo zrobić

400Nieprawidłowy parametr lub rozmiar strony. Popraw zapytanie; nie powtarzaj bez zmian.

401 / 403Brak klucza, klucz nieprawidłowy, wygasły, nieaktywny lub brak dostępu do źródła. Sprawdź odpowiedź i abonament; nie ponawiaj bez zmian.

404Nie znaleziono pojazdu lub lotu. Pokaż brak wyniku; nie wymyślaj ceny.

429Limit zapytań. Respektuj Retry-After, jeśli występuje; ogranicz ponowienia i uwzględnij pakiet.

5xx / timeoutPonawiaj tylko bezpieczne odczyty, ograniczając liczbę prób. Zachowaj ostatni udany punkt kontrolny; nie loguj kluczy ani pełnych odpowiedzi.

Błędy uwierzytelniania

403{ "error": "please add auth key in x-api-key header" }
403{ "error": "wrong api key" }
403{ "error": "your api subscription has expired" }
403{ "error": "your api subscription is not active" }

Bezpiecznie czytaj odpowiedź

Kontrole aplikacji zwykle zwracają obiekt z error; awarie frameworka i bramki używają message.
Bramka, proxy lub serwer WWW mogą zwrócić HTML, zwykły tekst lub pustą treść, nawet gdy zażądano JSON.
Ponawiaj tylko bezpieczne żądania GET, z ograniczonym budżetem i rosnącymi opóźnieniami. Zachowaj ostatni udany punkt kontrolny.