Was Standortdaten "in Echtzeit" tatsächlich erfordern
Echtzeit wird als Synonym für schnell verwendet. Eigentlich sollte es bedeuten, dass die Antwort den aktuellen Zustand der Welt widerspiegelt, nicht eine Momentaufnahme aus dem letzten Quartal.
Schlagwort
#api-design
Wie wir mit leeren Ergebnissen und Ergebnissen geringer Zuverlässigkeit umgehen
Wenn sich eine Anfrage wirklich nicht zuverlässig auflösen lässt, ist es die bessere Antwort, nichts zurückzugeben, statt eine als Tatsache verkleidete Vermutung. Hier ist die Begründung für diese Entscheidung.
Warum Höhendaten als Nebensache behandelt werden
Höhendaten bekommen auf einer Preisseite selten eine eigene Zeile, und dieses Fehlen verrät etwas Echtes darüber, wie ernsthaft sie tatsächlich aufgebaut werden.
Warum grundlegende Authentifizierungsmethoden keinen Aufpreis kosten sollten
Ein Header, ein Bearer-Token und ein Query-Parameter authentifizieren eine Anfrage alle auf dieselbe Weise. Für einen davon mehr zu verlangen heißt, eine Vorliebe zu berechnen, keine Funktion.
Unterschiede beim Ratenlimit, mit denen Sie beim Anbieterwechsel rechnen sollten
Ratenlimits unterscheiden sich zwischen Anbietern im Aufbau, nicht nur in der Zahl. Das sollten Sie prüfen, bevor Sie annehmen, dass Ihre bisherige Logik weiterhin gilt.
Warum wir lieber mit einem Fehler antworten als mit einer falschen Vermutung
Eine falsche Antwort, die selbstsicher wirkt, ist schlimmer als ein ehrlicher Fehlschlag. Ein Fehler sagt Ihnen, dass Sie etwas prüfen sollten. Eine selbstsichere falsche Vermutung sagt Ihnen, dass alles in Ordnung ist.
Eine serverseitige Integration migrieren, ohne den Client anzufassen
Eine serverseitige Geokodierungsmigration kann für die davon abhängigen Client-Anwendungen oft unsichtbar bleiben. So gestalten Sie sie entsprechend.
Warum Preisstufen nach Land eine schlechte Idee sind
Für die Abfrage einer Adresse in einem Land mehr zu verlangen als in einem anderen behandelt die Geografie selbst als Preishebel statt als ganz gewöhnliche Daten, die ausgeliefert werden.
Warum Postleitzahlabfragen als vollwertig behandelt werden sollten
Ein Postleitzahl-Endpunkt, der wie eine Nebensache bepreist und dokumentiert wird, wird auch wie eine Nebensache gebaut. Ihn ernst zu nehmen beginnt damit, ihn gleichwertig zu behandeln.
Was die Branche bei der IPv6-Einführung noch immer falsch macht
Eine IP-Abfrage-API, die IPv6 immer noch als unbedeutenden Sonderfall behandelt, behandelt stillschweigend einen wachsenden Anteil des echten Internet-Traffics als Nebensache.
Warum es Kontingente sowohl auf Konto- als auch auf Netzwerkebene geben sollte
Ein Kontingent auf Kontoebene erfasst, wer Sie sind. Ein Kontingent auf Netzwerkebene erfasst, woher Ihr Traffic tatsächlich kommt. Ein ernsthaftes System braucht beides.
Ein saubereres Fehlerformat für alle Endpunkte
Jeder Endpunkt gibt Fehler jetzt in einem einheitlichen, konsistenten Format zurück, sodass sich Fehlschläge leichter erkennen, protokollieren und programmatisch behandeln lassen.
Warum reine Webhook-APIs Batch-Nutzer stillschweigend ausschließen
Ein Webhook funktioniert gut für eine Anfrage nach der anderen. Er funktioniert schlecht für ein Skript, das einfach tausend Abfragen senden und auf tausend Antworten warten will.
Warum wir unsere Fehlercodes veröffentlichen, statt sie zu verstecken
Ein undokumentierter Fehlercode macht jede fehlgeschlagene Anfrage zu einem Ratespiel. Die Liste zu veröffentlichen ist eine Kleinigkeit, die echte Zeit bei der Fehlersuche spart.
Warum Batch-Preise den Preisen für Einzelanfragen entsprechen sollten
Tausend einzeln gesendete Abfragen und tausend als Batch gesendete Abfragen sind derselbe Arbeitsaufwand. Der Preis sollte nicht davon abhängen, wie sie verpackt wurden.
Ein Plädoyer für langweilige, stabile API-Versionierung
Eine aufregende neue API-Version ist ein Migrationsprojekt für alle, die davon abhängen. Langweilige, stabile Versionierung ist eine Funktion, kein Mangel an Ehrgeiz.
Warum wir nicht zuerst ein Browser-SDK gebaut haben
Ein Browser-SDK für eine serverseitige Abfrage verlagert Ihren API-Schlüssel meist nur an eine Stelle, an der der Browser eines Besuchers ihn sehen kann. Das ist keine Bequemlichkeit, die man haben sollte.
Was Ratenlimits auf Netzwerkebene lösen, was Limits pro Schlüssel nicht können
Ein Limit pro Schlüssel allein geht davon aus, dass ein Schlüssel einen Nutzer bedeutet. Ein Ratenlimit pro Netzwerk schließt die Lücke, in der diese Annahme stillschweigend zusammenbricht.
Postleitzahlen verdienen mehr Anerkennung, als sie bekommen
Postleitzahlabfragen werden neben der Geokodierung als kleines Hilfswerkzeug behandelt, haben aber eine echte Struktur und echte regionale Unterschiede, die dieselbe Sorgfalt verdienen.
Warum die Qualität der Dokumentation wichtiger ist als die Zahl der Funktionen
Eine Funktion, deren Nutzung Sie nicht herausfinden können, könnte genauso gut gar nicht existieren. Dokumentation ist kein Supportkostenfaktor, sie ist Teil des eigentlichen Produkts.
Die stillen Kosten der Anbieterbindung
Anbieterbindung zeigt sich selten als eine einzelne schlechte Entscheidung. Sie zeigt sich als hundert kleine, die einen Wechsel stillschweigend viel teurer machen, als einfach zu bleiben.
Ratenlimits sollten dokumentiert sein, nicht erst entdeckt werden
Ihr Ratenlimit durch einen 429-Fehler im Produktivbetrieb herauszufinden ist keine Dokumentation. Es ist ein Support-Ticket, das es nie hätte geben müssen.
Warum wir Sammelanfragen pro Element zählen, nicht pro Aufruf
Ein Batch-Aufruf mit tausend Adressen führt immer noch tausend einzelne Abfragen aus. Ihn als eine Anfrage zu zählen würde nur verschleiern, wohin die tatsächliche Nutzung ging.
Warum proprietäre Antwortformate keine gute Idee sind
Ein proprietärer Feldname oder ein eigenes Objektmodell spart einem Anbieter nichts und kostet einen Kunden später eine Neuentwicklung. Schlichtes, vorhersehbares JSON ist keine fehlende Funktion.
Was die Abrechnung pro Produkt an der Art, wie APIs genutzt werden, falsch versteht
Echte Anwendungen kombinieren Geokodierung, IP-Abfragen und Zeitzonenaufrufe in einem einzigen Anfrageablauf. Sie als getrennte Produkte abzurechnen ignoriert, wie sie zusammen genutzt werden.
Offene Zeitzonendaten sollten keine Premium-Funktion sein
Zeitzonenabfragen beruhen auf einer öffentlichen, aktiv gepflegten Datenquelle. Einen separaten Aufpreis für diese Abfrage zu verlangen spiegelt keine echten zusätzlichen Kosten wider.
Warum Kompatibilitäts-Hosts wichtiger sind als ein neues SDK
Ein SDK verlangt, dass Sie der Client-Bibliothek eines Unternehmens für die gesamte Lebensdauer Ihres Projekts vertrauen. Ein Kompatibilitäts-Host verlangt, dass Sie eine Konfigurationszeile ändern.
Warum wir pro Anfrage abrechnen und nicht pro Nutzerplatz
Ein Preis pro Anfrage entspricht dem, was der Betrieb einer API tatsächlich kostet. Preise pro Nutzerplatz messen die Mitarbeiterzahl, nicht die Nutzung, und Geokodierungs-Traffic folgt selten einem von beiden.