IPv4 und IPv6 in IP-APIs

Wie eine IP-API mit IPv4 und IPv6 umgeht, legt der Vertrag zwischen Client und API fest. Ein Client sollte zwischen Erfolg, Validierungsfehlern, fehlgeschlagener Authentifizierung, Ratenbegrenzungen und vorübergehenden Serverfehlern unterscheiden. Ob JSON oder XML, ändert nichts an der HTTP-Semantik, und IPv4/IPv6-Werte müssen vollständig erhalten bleiben, ohne von der Länge einer IPv4-Adresse auszugehen.

So verarbeiten Sie die Antwort

Prüfen Sie Content-Type, Statuscode, dokumentierte Felder und Kontingent. Behandeln Sie HTTP 429 gesondert, beachten Sie Retry-After, sofern angegeben, und verwenden Sie einen begrenzten exponentiellen Backoff mit Jitter. Klären Sie vor jeder Wiederholung, ob der Vorgang idempotent ist. Protokollieren Sie Anfrage-IDs, Status und Latenz, aber niemals API-Geheimnisse.

IPv6-Adressen vollständig speichern

Legen Sie ein Adressfeld aus einer IP-API nicht in einem Schema ab, das nur für IPv4 in Punktnotation gedacht ist. Speichern Sie stattdessen den kanonischen IPv6-Text oder eine geeignete Binärdarstellung, akzeptieren Sie bei der Eingabe komprimierte Formen und testen Sie Loopback-, Mapped- oder Dual-Stack-Fälle gemäß dem API-Vertrag. Wie das in einer echten Anfrage aussieht, zeigt der aktuelle API-Vertrag der 2IP API.