Saber que existe un host de compatibilidad es una cosa. Saber exactamente cómo trasladar a él una integración existente, sin romper nada por el camino, es otra. Creamos un conjunto dedicado de guías de migración para cerrar esa brecha, reunidas en /docs/compatibility/.
Las guías recorren los pasos prácticos del cambio: qué cambia en una solicitud, qué se mantiene igual, qué método de autenticación usar y a qué prestar atención en la respuesta, proveedor por proveedor y endpoint por endpoint. Como cada uno de nuestros diecisiete hosts de compatibilidad reproduce exactamente la forma de solicitud y respuesta de su proveedor original, salvo los textos de copyright, términos y privacidad, las guías se centran sobre todo en las partes que realmente difieren: el nombre del host al que apuntar, la clave que hay que generar y las cabeceras de cuota que ahora acompañan a cada respuesta.
Las escribimos pensando en un lector concreto: alguien que ya tiene código funcionando con otro proveedor y quiere seguridad, no solo una promesa, de que apuntarlo hacia nosotros seguirá funcionando. Eso implica ser explícitos también sobre los precios durante la transición. Todos los endpoints y todos los hosts de compatibilidad cuestan lo mismo, con 2.500 solicitudes gratuitas al día desde cualquier dirección y otras 2.500 solicitudes gratuitas al día por clave, así que probar una migración no cuesta nada antes de comprometerte.
Cada guía cubre además los pequeños detalles que suelen hacer tropezar una migración si no se tienen en cuenta: cómo se cuentan las solicitudes por lotes, ya que una llamada masiva cuenta cada elemento por separado y no la llamada en su conjunto, y qué significan las cabeceras de cuota adicionales de cada respuesta si no las has visto antes. Nada de eso requiere hacer suposiciones una vez que tienes abierta la guía correspondiente junto a tu código.
Para un equipo que está valorando si cambiar, el camino recomendado es sencillo: lee la guía del proveedor que uses actualmente, genera una clave y prueba unas cuantas solicitudes reales contra el host compatible antes de tocar ningún código de producción. Como la cuota gratuita cubre por completo esas pruebas, comparar ambos lado a lado antes de decidir no cuesta nada.
La lista completa de hosts de compatibilidad que cubren estas guías está en /compatibility/, y la documentación general de autenticación y de límites de frecuencia que se aplica a todos ellos está en /docs/authentication/ y /docs/rate-limits/. Tenemos previsto seguir ampliando esta colección de guías a medida que crezca la cobertura de compatibilidad.