Hacer que tus sistemas se comuniquen entre sí, de forma fiable

REST para la mayoría de los casos, y GraphQL cuando un cliente necesita componer sus propias consultas sobre datos relacionados —normalmente una app móvil que busca reducir los viajes de ida y vuelta. GraphQL añade complejidad real en caché, limitación de tasa y control de costes de consulta, por lo que necesita una razón más allá de la preferencia.

A menudo, aunque seremos claros sobre los compromisos. Las opciones son una integración a nivel de base de datos si podemos acceder a ella, intercambio de archivos programado o, como último recurso, extracción de datos de pantalla —que funciona pero se rompe cada vez que el otro lado cambia su marcado. Cotizamos el scraping como mantenimiento continuo en lugar de un trabajo puntual, porque es lo que es.

Eso se diseña desde el principio. Las llamadas salientes pasan por una cola con reintentos y un disyuntor, por lo que un proveedor que falla implica una acción retrasada en lugar de una solicitud fallida o una página 500. Cualquier cosa irrecuperable termina en una cola de mensajes muertos con una alerta, por lo que nada se pierde en silencio.

Sí, generada a partir de la especificación OpenAPI para que no quede obsoleta, publicada con ejemplos funcionales y un entorno de pruebas para probar contra él. La documentación de API escrita a mano queda desactualizada en dos versiones, por eso no la hacemos así.

Versionado en la ruta de la URL, con una política de desuso escrita —los cambios aditivos van a la versión actual, los cambios que rompen la compatibilidad generan una nueva versión, y la antigua sigue disponible durante un período acordado. Los consumidores planifican en torno a ello en lugar de descubrirlo.