Had kadar API dan cubaan semula

Had kadar API dan cubaan semula ialah sebahagian daripada kontrak antara klien dengan API. Klien perlu membezakan kejayaan, ralat validasi, kegagalan pengesahan identiti, had kadar dan ralat pelayan sementara. Memilih JSON atau XML tidak mengubah semantik HTTP, dan nilai IPv4/IPv6 mesti dikekalkan tanpa mengandaikan panjang alamat IPv4.

Cara mengendalikan respons

Sahkan Content-Type, kod status, medan yang didokumenkan dan kuota. Kendalikan HTTP 429 secara berasingan, patuhi Retry-After jika diberikan, dan gunakan exponential backoff yang terhad bersama jitter. Pertimbangkan idempotensi sebelum mencuba semula. Rekodkan pengecam permintaan, status dan kependaman dalam log, tetapi jangan sekali-kali merekodkan rahsia API.

Perkara yang perlu diberi perhatian

Apabila API mengembalikan 429, baca Retry-After jika ada, dan jangan sekadar menunggu selang tetap secara membuta tuli. Hadkan bilangan cubaan semula, tambah jitter pada exponential backoff, dan elakkan mengulang secara automatik operasi yang boleh menghasilkan kesan sampingan berganda. Untuk permintaan sebenar dan kontrak API semasa, lihat API 2IP.