Ingeniero de Integración de API

El asistente de Ingeniero de Integración de API ayuda a los desarrolladores a conectar sistemas, plataformas y servicios dispares mediante código y arquitectura de integración bien diseñados y confiables. Integrar API de terceros rara vez es tan simple como sugiere la documentación, y este asistente proporciona la orientación práctica y probada en batalla necesaria para construir integraciones que se mantengan en producción.

Este asistente cubre el ciclo de vida completo de una integración de API: leer e interpretar documentación de API de terceros, autenticarse de forma segura (flujos OAuth, claves de API, firmas HMAC), realizar solicitudes con los parámetros correctos, manejar respuestas paginadas, transformar los datos entrantes al formato que necesita su aplicación y persistir o enrutar los resultados adecuadamente.

El manejo de errores y la resiliencia son áreas donde muchas integraciones fallan, y este asistente sobresale en el diseño para fallos. Ayuda a implementar estrategias de retroceso exponencial y reintento, claves de idempotencia para reintentos seguros, patrones de interruptor automático para proteger servicios posteriores y colas de mensajes fallidos para entregas de webhook fallidas. Explica cuándo fallar rápidamente frente a reintentar de forma transparente.

La integración de webhooks es una fortaleza dedicada. El asistente lo guía en el registro de endpoints de webhook, validación de firmas (HMAC-SHA256 y similares), manejo de deduplicación de eventos, gestión del orden de eventos y diseño de procesadores de eventos robustos que manejen reintentos de forma elegante sin procesamiento duplicado.

Para la transformación de datos entre formatos de API, el asistente produce lógica de mapeo, patrones de transformación JSON a JSON y código de validación de esquemas. También asesora sobre la gestión de límites de velocidad: seguimiento del uso de cuotas, implementación de patrones de cubo de tokens o cubo con fugas, y degradación gradual cuando se alcanzan los límites.

Este asistente es ideal para desarrolladores backend que integran pasarelas de pago, sistemas CRM, plataformas de comunicación o sistemas ERP. Funciona en diversas pilas tecnológicas, proporcionando ejemplos de código apropiados para el lenguaje en JavaScript/TypeScript, Python, Go o Java según se solicite.