JSON- vs. XML-APIs

Ob JSON oder XML zum Einsatz kommt, 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.

Was für JSON und was für XML spricht

JSON passt direkt zu den gängigen Datenmodellen aus Objekten und Arrays und ist meist kompakt; XML unterstützt Attribute, Namespaces und ausgereifte Schema-Werkzeuge. Entscheiden Sie anhand des API-Vertrags und des Ökosystems, statt anzunehmen, dass ein Format grundsätzlich schneller oder korrekter ist. Den aktuellen API-Vertrag und eine echte Beispielanfrage finden Sie bei der 2IP API.