Saltar al contenido principal

Consumo de Servicio Externo

Consumir un servicio · Cliente de API · Integración saliente · Conector externo · Consumo de API de terceros
Etiquetas:

Ejemplos​

Consumo de Google Maps: el sistema invoca el servicio del proveedor para incrustar un mapa renderizado, incorporando una capacidad de terceros sin desarrollarla internamente.

Descripción​

Componente mediante el cual el sistema invoca un servicio provisto por un sistema externo para obtener información o delegar una operación que no resuelve por sí mismo. El sistema actúa como cliente: construye la solicitud según el contrato del tercero, la envía, y procesa la respuesta recibida para incorporarla a su propio flujo. Es el lado «cliente» de una integración entre sistemas, y permite incorporar capacidades de terceros (mapas, pagos, validaciones) sin desarrollarlas internamente.

Capacidades mandatorias​

Capacidades mandatorias
  • Construye solicitudes hacia un servicio externo respetando el contrato (especificación) que define el tercero
  • Envía la solicitud y recibe la respuesta del sistema externo
  • Interpreta y procesa la respuesta recibida para incorporarla al flujo del sistema
  • Gestiona las credenciales con las que el sistema se identifica ante el servicio externo

Capacidades adicionales​

Capacidades adicionales
  • Manejo de fallos y reintentos: reintenta la invocación o aplica una alternativa cuando el servicio externo no responde o devuelve error, evitando que la falla externa interrumpa el sistema
  • Caching de respuestas externas: almacena temporalmente respuestas del tercero para reducir llamadas repetidas y dependencia de su disponibilidad
  • Transformación de datos: adapta el formato de la respuesta externa al modelo de datos interno del sistema
  • Monitoreo de la integración: registra latencias, errores y disponibilidad del servicio externo consumido

Delimitaciones​

Qué no es
  • No expone funcionalidades propias a terceros — eso corresponde a Servicio Expuesto: aquí el sistema es el que usa un servicio ajeno, no el que lo ofrece
  • No controla ni implementa el servicio externo: depende del contrato y la disponibilidad que define el tercero
  • No es un Scraper: el consumo de servicio usa un contrato formal y autorizado provisto por el tercero; el Scraper extrae datos de una interfaz no diseñada para ser consumida programáticamente
  • No es un ETL: aunque ambos traen datos externos, el ETL ejecuta cargas masivas planificadas; el consumo de servicio invoca operaciones puntuales según la necesidad del sistema

Flujo de información​

Entrada

Respuesta estructurada que devuelve el servicio externo (datos solicitados o confirmación de la operación)

→
Salida

Solicitud estructurada que el sistema envía hacia el servicio externo (operación, parámetros, credenciales)

Modalidades​

  • Consumo de consulta: el sistema invoca al tercero para obtener información (p. ej. consultar una tasa de cambio, una ubicación, un puntaje crediticio)
  • Consumo de operación: el sistema invoca al tercero para que ejecute una acción (p. ej. iniciar un cobro, enviar un correo a través de un proveedor)
  • REST / SOAP / GraphQL: según el protocolo que defina el servicio externo a consumir

Dependencias típicas​

  • Servicio externo provisto por un tercero, con su contrato y documentación
  • Credenciales de acceso al servicio externo (API key, token, certificado) y su almacenamiento seguro
  • Autenticación API para identificarse ante el servicio externo que se consume
  • Conectividad de red hacia el sistema externo

Mapeo al Tablero Digital​

Actualización ManualNo
Actualización AutomáticaSiempre
Conceptos de DatosSiempre
Salidas por DemandaNo
Salidas AutomáticasSiempre
Procesos AutónomosSiempre
SecciónVínculoObservación
Actualización ManualNo—
Actualización AutomáticaSiempreLa respuesta que llega desde el servicio externo y se incorpora al sistema.
Conceptos de DatosSiempreLas entidades del sistema que se enriquecen o se validan con la información del servicio externo.
Salidas por DemandaNo—
Salidas AutomáticasSiempreLa solicitud estructurada que el sistema envía hacia el servicio externo.
Procesos AutónomosSiempreLa lógica que arma la solicitud, interpreta la respuesta y maneja fallos, reintentos y caching cuando esas capacidades están presentes.

Ejemplo de Tablero Digital​

Actualización Manual
—
Conceptos de Datos
Dirección
Coordenadas
Ruta
Salidas por Demanda
—
Actualización Automática
Respuesta de Geocoding
Respuesta de Cálculo de Ruta
Procesos Autónomos
Armado de Solicitud
Interpretación de Respuesta
Manejo de Fallos y Reintentos
Salidas Automáticas
Solicitud a Google Maps