Plataformas / 01
API REST disponible. Integración pendiente.
La documentación está disponible y una solicitud de prueba funciona. Aun así, en el día a día faltan datos o aparecen registros duplicados. DataSource conecta su API REST con el proceso empresarial concreto y contempla también la ausencia de respuesta.
La situación inicial
Una solicitud correcta es solo el principio.
Un portal debe recibir clientes de un ERP. Los sistemas utilizan ID y campos obligatorios diferentes. El ERP entrega resultados paginados y el portal limita las escrituras. Una exportación manual oculta estas diferencias, pero no las resuelve.
Antes de implementar, verificamos la versión de API compatible, el volumen de datos, la frecuencia de actualización requerida y el contrato de destino. Un documento OpenAPI ayuda; las respuestas reales anonimizadas y los mensajes de error son igualmente importantes.
Qué hace DataSource
Contrato de datos, acceso y recuperación.
Contrato de datos
Acordar campos de origen y destino, identidades, tipos de datos y valores obligatorios. Definir reglas para valores ausentes y cambios del esquema.
Acceso y transferencia
Implementar autenticación, alcance de permisos y renovación de tokens conforme a la API. Contemplar paginación, límites temporales y orden de los objetos dependientes.
Recuperación
Registrar el progreso de transferencia y los ID externos para poder retomar ejecuciones interrumpidas. Conciliar primero una respuesta de escritura incierta antes de volver a escribir.
Escenario técnico / Ejemplo ilustrativo
Conciliar clientes sin crearlos por duplicado.
El ejemplo muestra un contrato de destino propuesto. El ID externo del cliente es la clave operativa. El upsert y los mecanismos de idempotencia deben estar soportados por la API de destino o implementarse en la integración.
Datos de ejemplo y reglas propuestas. Las interfaces y reglas empresariales concretas se verifican para su proyecto.
PUT /customers/004218
Content-Type: application/json
{
"externalId": "004218",
"name": "Beispiel GmbH",
"countryCode": "AT"
}Gestión de errores, seguridad y operación
Interpretar correctamente los errores HTTP.
Límites de solicitudes
Ante HTTP 429, respetar las especificaciones de la API y, si procede, Retry-After. Planificar reintentos limitados con backoff; los errores persistentes de validación requieren una corrección.
Conflictos de modificación
Utilizar ETags o campos de versión cuando estén disponibles. Un registro modificado entretanto no debe sobrescribirse con una versión antigua.
Operación
Documentar ID de correlación, contadores y categorías de error. Los tokens y payloads completos con datos personales no deben aparecer en los logs operativos generales.
Preguntas operativas
Detalles importantes antes de implementar.
HTTP · REST · OAuth · API Keys · Paginación · Retry
¿Puede cualquier API ejecutar un upsert?
No. Algunas solo ofrecen endpoints separados de creación y actualización. En ese caso, la integración necesita una asignación fiable y un procedimiento para resultados inciertos.
¿Necesitamos tiempo real?
Depende del proceso empresarial. El polling puede bastar; los webhooks son útiles cuando el origen notifica los cambios de forma fiable. La conciliación sigue siendo útil para eventos omitidos.
¿Qué ocurre con una nueva versión de la API?
Verificamos contratos y escenarios de error representativos en un entorno de pruebas. Los plazos de deprecación, el cambio y el procedimiento de retorno se acuerdan antes de modificar producción.
Para el análisis técnico
Empezar por su proceso concreto.
Aporte documentación de API, versión, ejemplos anonimizados, dirección deseada y frecuencia de actualización. Son útiles los límites conocidos y qué sistema gestiona cada campo.
En la primera conversación aclaramos los accesos disponibles, las responsabilidades sobre los datos y un primer flujo delimitado. Después acordamos alcance, responsabilidades y condiciones.
Consulta de proyecto
¿Qué API deben trabajar juntas?
Describa brevemente el proceso actual y el resultado deseado.
Tareas relacionadas
La próxima conexión en contexto.
Procesar webhooks de forma fiable
Llega un evento y debe activar una acción en el siguiente sistema. Las entregas múltiples, los retrasos o una API de destino caída convierten esto en un proceso operativo. Desarrollamos ese proceso con eventos claros y efectos verificables.
Transformación de datos JSON / XML
Los datos se pueden leer técnicamente, pero aun así se rechazan. Los nombres de campos, tipos o estructuras no encajan con la aplicación de destino. Desarrollamos mapeos trazables que también contemplan valores vacíos, casos especiales y cambios del formato de origen.
Sincronizar datos entre sistemas
Un cliente se modifica en el CRM y también en el ERP. ¿Qué versión es válida? Diseñamos la sincronización a partir de responsabilidades operativas e identidades estables para evitar conflictos silenciosos en las transferencias periódicas.
Referencias técnicas
Documentación oficial, revisada el 6 de octubre de 2026. La idoneidad depende de la instalación y versión concretas.