> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom API

> Configura un paso del flujo de trabajo que realiza una solicitud HTTP y almacena la respuesta para pasos posteriores

# 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

| Opción                                                                                                                         | Requerido | Descripción                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------ | --------- | -------------------------------------------------------------------------------------------------- |
| Name                                                                                                                           | No        | Etiqueta del paso en el lienzo del flujo de trabajo.                                               |
| API Method                                                                                                                     | Sí        | Método HTTP en **API Method**. Los valores disponibles son `get` y `post`.                         |
| API URL                                                                                                                        | Sí        | URL en **API URL**. Este campo admite variables del flujo de trabajo mediante **Insert Variable**. |
| Headers                                                                                                                        | No        | Cadena JSON ingresada en **Headers**.                                                              |
| Body                                                                                                                           | No        | Cadena JSON ingresada en **Body**. Este campo solo se muestra cuando **API Method** es `POST`.     |
| Retry Count                                                                                                                    | No        | Número de reintentos en **Retry Count**.                                                           |
| When the step fails                                                                                                            | No        | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla.     |
| Agrega este paso desde el grupo **Utilities** en **Search steps...**. En el selector de pasos, la etiqueta es **Call an API**. |           |                                                                                                    |

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:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

Si solo necesitas el payload completo de la respuesta, referencia directamente la salida base:

```text theme={null}
{{step_2.output}}
```

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.

{/* Add screenshot: Custom API settings sheet with URL, headers, and body */}

## 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](../../creating-and-editing), [Pruebas e iteración](../../testing-and-iteration) y [Manejo de errores](../../error-handling)