IPv4 dan IPv6 dalam API IP

Cara mengendalikan IPv4 dan IPv6 dalam API IP bergantung pada 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

Jangan simpan medan API IP dalam skema yang saiznya hanya muat untuk IPv4 bertitik. Simpan teks IPv6 kanonik atau perwakilan binari yang sesuai, terima bentuk termampat sebagai input, dan uji kes loopback, alamat terpeta (mapped) atau dwi-tindanan (dual-stack) mengikut kontrak API. Untuk permintaan sebenar dan kontrak API semasa, lihat API 2IP.