Skip to main content

​
Custom API

Usa Custom API cuando quieras que un paso del flujo de trabajo llame a un endpoint HTTP externo desde Fetch Hive y pase la respuesta a pasos posteriores.

​
Configuración

El panel de configuración tiene campos separados para API URL, Headers y Body. Cada campo puede incluir valores de Inputs o de Workflow Steps anteriores con Insert Variable.

​
Salida

Haz clic en Run en el encabezado del paso para probar la solicitud. Fetch Hive muestra la respuesta en Output después de que se complete la ejecución. Usa el selector de variables en un paso posterior para insertar la ruta exacta de respuesta disponible para esa ejecución. La referencia base es:
Si solo necesitas el payload completo de la respuesta, referencia directamente la salida base:
Si la respuesta es un objeto estructurado, el selector de variables muestra los campos anidados que puedes insertar en pasos posteriores.

​
Ejemplo

Agrega Call an API desde el grupo Utilities en Search steps…. Establece Name en algo como Fetch customer profile. Elige GET o POST en API Method. Ingresa el endpoint en API URL. Si el endpoint necesita datos de pasos anteriores, haz clic en Insert Variable y agrega valores como {{step_1.output.customer_id}}. Si la solicitud necesita encabezados de autenticación o de contenido, agrégalos en Headers como JSON. Si usas POST, agrega el payload de la solicitud en Body. Ajusta Retry Count y elige qué debe pasar en When the step fails. Haz clic en Run y revisa la respuesta de la API en Output antes de conectar esa salida a pasos posteriores.

​
Notas

  • La etiqueta del selector de pasos es Call an API, aunque esta página y archivo usan Custom API.
  • La vista de solo lectura del despliegue muestra la URL, el método, el conteo de reintentos y el comportamiento ante fallos. No muestra ahí el resumen completo de encabezados ni del cuerpo de la solicitud.
  • Usa JSON válido en Headers y Body si tu API downstream espera payloads JSON.
Consulta también: Creación y edición, Pruebas e iteración y Manejo de errores