> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/logic-steps/api.md).

# Llamar a la API

Llama API externas en tu flujo de trabajo

El paso de utilidad "API" permite que tus flujos de trabajo de AirOps se comuniquen con servicios externos a través de sus API. Esto te permite integrar e interactuar con datos y funcionalidades que están fuera de tu flujo de trabajo.

## Configuración

Elige el método requerido por la API externa:

| Método    | Uso común                                                                            |
| --------- | ------------------------------------------------------------------------------------ |
| **GET**   | Recuperar datos. Este es el método predeterminado y no envía un cuerpo de solicitud. |
| **POST**  | Crear un recurso o enviar datos.                                                     |
| **PUT**   | Reemplazar o actualizar un recurso.                                                  |
| **PATCH** | Actualizar campos seleccionados de un recurso.                                       |

**POST**, **PUT**, y **PATCH** acepta un **Cuerpo** con referencias de Liquid. El paso no admite DELETE. Los reintentos configurados se aplican a los cuatro métodos admitidos.

### Referenciar entradas o salidas en el paso API

Para establecer dinámicamente variables en tu API y hacer referencia a una entrada (definida en el paso "Inicio") o a una variable de salida (generada por cualquier paso), deberás usar la sintaxis de Liquid. Además, deberás especificar los valores de tus Encabezados y Cuerpo.

#### Encabezados

Para pasar el valor de tu encabezado, es importante que formatees la información como JSON. Siempre estableceremos nuestro Content-Type como se muestra a continuación, y puedes incluir la clave de API para cualquier llamada que requiera autorización:

```javascript
{ 
    "authorization": "Bearer SU_CLAVE_API",
    "Content-Type": "application/json"
}
```

#### Cuerpo

El cuerpo nos permite especificar cualquier parámetro adicional (es decir, variables o salidas) que deba incluirse en la llamada a la API. Usamos la misma sintaxis que en el encabezado, donde tanto nuestras claves como nuestros valores van entre comillas. Si vamos a pasar entradas o salidas de pasos, usamos la sintaxis de Liquid manteniéndolas entre comillas dobles, por ejemplo.

```javascript
{
  "properties": {
    "amount": "",
    "dealname": "{{ step_2.output.deal_name }}",
    "pipeline": "",
    "closedate": "{{ step_2.output.deal_close_date }}",
    "dealstage": "",
    "hubspot_owner_id": ""
  }
}
```

#### Ejemplos

Pongamos todo esto junto con un par de ejemplos. Si tienes una entrada de usuario definida como ubicación al inicio de tu flujo de trabajo, puedes incluir {{ location }} en la URL o en el cuerpo de tu paso de API para hacer una solicitud a una API meteorológica:

```
GET https://api.weatherapi.com/v1/current.json?key=YOUR_API_KEY&query={{ location }}
```

Del mismo modo, puedes usar salidas de otros pasos como variables. Si tienes un paso que recupera el ID de un usuario, puedes usar la salida de ese paso como variable en el paso API:

```
POST https://api.example.com/user/{{ step_1.output }}/profile
```

Esto te permite crear solicitudes de API dinámicas que se ajustan según las entradas y salidas de tu flujo de trabajo. Como ejemplo, puedes hacer referencia al paso de API que se muestra en nuestra plantilla "Sales Call Lead Qualifier" que aparece a continuación:

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a065521ad54d200f3084fb0592a7097497a6aa58%2Fapi-step-01-example.png?alt=media" alt="Call API step Get the Transcript from Fireflies sending a POST request to the Fireflies GraphQL API with headers and a body, followed by a Qualify the lead step"><figcaption><p>El paso Call API obtiene una transcripción de llamada de Fireflies.</p></figcaption></figure>

## Cómo continuar si el paso API falla

De forma predeterminada, el paso API terminará el flujo de trabajo si falla. Sin embargo, para continuar el flujo de trabajo si el paso falla, simplemente haz clic en `Continuar` en la parte inferior del paso.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c22e0f91e9ed6f30b38662ce911f8280e9c9bdf4%2Fstep-errors-03-continue-strip.png?alt=media" alt="Web Page Scrape step with When the step fails set to Continue"><figcaption><p>Selecciona Continuar para mantener el flujo de trabajo en ejecución cuando el paso falle.</p></figcaption></figure>

El paso devolverá las siguientes claves:

* `salida` : esto será `nulo`
* `error` :
  * `mensaje`: el mensaje devuelto por el paso
  * `código` : el código de error que representa el error

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42ed8e1d814a64451a4759ec04fab8fc35e89eff%2Fstep-errors-01-error-variable.png?alt=media" alt="Variables Menu previewing the Export pass schedule step, whose output is null and whose error has a message and the code STEP_ERROR"><figcaption><p>Un paso fallido devuelve un objeto de error con un mensaje y un código.</p></figcaption></figure>

## Cómo reintentar si el paso API falla

Puedes reintentar el paso API hasta 3 veces haciendo clic en **Configuración avanzada**

Sin embargo, si el paso aún falló después de 3 reintentos, puedes:

1. Selecciona `Continuar` en lugar de `Terminar el flujo de trabajo` si el paso falla
2. Añade una condición en la que se compruebe si el `error` del paso existe, por ejemplo: `step_1.error`
3. Añade el paso que quieras reintentar si hubo un error

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0cf37b9938c96511e3d7292034d8f5dc8c74d168%2Fstep-errors-02-retry-condition.png?alt=media" alt="Condition step Retry if export failed that checks step_1.error, with the retry Run Code step on the True branch"><figcaption><p>Comprueba si el paso falló y luego inténtalo de nuevo.</p></figcaption></figure>

## ¿Necesitas más control?

Para solicitudes API avanzadas, usa nuestro paso de Python con código personalizado, utilizando el [Paso de código](https://docs.airops.com/docs/code-step), que puede realizar solicitudes externas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/logic-steps/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
