Zu wissen, dass es einen Kompatibilitäts-Host gibt, ist das eine. Genau zu wissen, wie man eine bestehende Integration dorthin umzieht, ohne unterwegs etwas kaputtzumachen, ist etwas anderes. Um diese Lücke zu schließen, haben wir eine eigene Reihe von Migrationsleitfäden erstellt, gesammelt unter /docs/compatibility/.
Die Leitfäden führen durch die praktischen Schritte des Wechsels: was sich an einer Anfrage ändert, was gleich bleibt, welche Authentifizierungsmethode Sie verwenden sollten und worauf Sie in der Antwort achten müssen, Anbieter für Anbieter, Endpunkt für Endpunkt. Da jeder unserer siebzehn Kompatibilitäts-Hosts die Anfrage- und Antwortstruktur des ursprünglichen Anbieters exakt nachbildet, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, konzentrieren sich die Leitfäden vor allem auf die Teile, die sich wirklich unterscheiden: den Host-Namen, auf den Sie zeigen, den Schlüssel, den Sie erzeugen, und die Kontingent-Header, die nun jede Antwort begleiten.
Wir haben sie für eine bestimmte Leserschaft geschrieben: Menschen, die bereits funktionierenden Code für einen anderen Anbieter haben und Gewissheit wollen, nicht nur ein Versprechen, dass er weiter funktioniert, wenn sie ihn auf uns ausrichten. Das bedeutet auch, bei den Preisen während der Umstellung klar zu sein. Jeder Endpunkt und jeder Kompatibilitäts-Host kostet gleich viel, mit 2.500 kostenlosen Anfragen pro Tag von jeder Adresse und weiteren 2.500 kostenlosen Anfragen pro Tag pro Schlüssel. Eine Migration zu testen kostet also nichts, bevor Sie sich festlegen.
Jeder Leitfaden behandelt auch die kleinen Details, über die eine Migration gerne stolpert, wenn man sie nicht beachtet: wie Batch-Anfragen gezählt werden, denn ein Massenaufruf zählt jedes Element einzeln und nicht den Aufruf als Ganzes, und was die zusätzlichen Kontingent-Header in jeder Antwort bedeuten, falls Sie ihnen noch nicht begegnet sind. Nichts davon erfordert Rätselraten, sobald der passende Leitfaden neben Ihrem Code geöffnet ist.
Für ein Team, das einen Umstieg abwägt, ist der empfohlene Weg einfach: Lesen Sie den Leitfaden für den Anbieter, den Sie derzeit nutzen, erzeugen Sie einen Schlüssel und testen Sie eine Handvoll echter Anfragen gegen den kompatiblen Host, bevor Sie Produktionscode anfassen. Da das kostenlose Kontingent diese Tests vollständig abdeckt, kostet es nichts, beide vor der Entscheidung direkt zu vergleichen.
Die vollständige Liste der Kompatibilitäts-Hosts, die diese Leitfäden abdecken, finden Sie unter /compatibility/, und die allgemeine Dokumentation zu Authentifizierung und Ratenlimits, die für alle gilt, unter /docs/authentication/ und /docs/rate-limits/. Wir planen, diese Sammlung von Leitfäden weiter auszubauen, wenn die Kompatibilitätsabdeckung wächst.