IP API'lerinde IPv4 ve IPv6

IP API'lerinde IPv4 ve IPv6 adreslerinin nasıl işleneceğini istemci ile API arasındaki sözleşme belirler. İstemci başarılı yanıtı, doğrulama hatasını, kimlik doğrulama hatasını, hız sınırını ve geçici sunucu hatasını birbirinden ayırt edebilmelidir. JSON ya da XML kullanmak HTTP semantiğini değiştirmez; IPv4/IPv6 değerleri de IPv4 uzunluğu varsayılmadan eksiksiz saklanmalıdır.

Yanıtı doğrulamak

Content-Type'ı, durum kodunu, belgelenmiş alanları ve kotayı kontrol edin. HTTP 429'u ayrıca ele alın: Retry-After gönderilmişse ona uyun; jitter eklenmiş ve üst sınırı olan üstel geri çekilme (exponential backoff) kullanın. Yeniden denemeden önce işlemin idempotent olup olmadığını düşünün. İstek kimliklerini, durum kodunu ve gecikmeyi loglayın, ama API anahtarlarını hiçbir zaman loglara yazmayın.

IPv6 değerlerini eksiksiz saklamak

IP API'sinden gelen alanı yalnızca noktalı IPv4 adresine göre boyutlandırılmış bir şemada saklamayın. IPv6'yı kanonik metin biçiminde ya da uygun bir ikili gösterimle saklayın, girdide kısaltılmış (sıkıştırılmış) yazımları kabul edin ve API sözleşmesine göre loopback, eşlenmiş (mapped) ve çift yığın (dual-stack) durumlarını test edin. Gerçek bir istek denemek ve güncel API sözleşmesini görmek için 2IP API'si sayfasına bakın.