Limity zapytań API i ponawianie żądań

Limity zapytań API i ponawianie żądań są częścią kontraktu między klientem a API. Klient powinien odróżniać sukces, błędy walidacji, błędy uwierzytelniania, limity zapytań i tymczasowe błędy serwera. Wybór między JSON a XML nie zmienia semantyki HTTP, a wartości IPv4/IPv6 trzeba zachowywać bez założeń o długości typowej dla IPv4.

Jak obsłużyć odpowiedź

Weryfikuj Content-Type, kod statusu, udokumentowane pola i limit wywołań. Obsługuj HTTP 429 osobno, respektuj Retry-After, jeśli zostanie podany, i stosuj ograniczony wykładniczy backoff z jitterem. Przed ponowieniem żądania weź pod uwagę idempotentność. Loguj identyfikatory żądań, status i opóźnienie, ale nigdy sekrety API.

Na co zwrócić uwagę

Gdy API zwraca 429, odczytaj Retry-After, jeśli jest obecny, zamiast na ślepo czekać stały czas. Ogranicz liczbę ponowień, dodaj jitter do wykładniczego backoffu i unikaj automatycznego powtarzania operacji, które mogą wywołać zduplikowane skutki uboczne. Rzeczywiste zapytania i aktualny kontrakt opisuje strona API 2IP.