Capítulo 2 de 6 · 8 min

Tu primera integración

Das de alta una integración contra una API pública de cotizaciones, la probás desde Configuración y guardás su respuesta como ejemplo.

Vamos a usar DolarApi, un servicio público y gratuito que publica las cotizaciones del dólar en Argentina. No pide cuenta ni clave, así que es ideal para la primera integración: te concentrás en Nxar y no en las credenciales.

Si abrís https://dolarapi.com/v1/dolares/oficial en el navegador vas a ver algo así (los números cambian todos los días):

{
  "moneda": "USD",
  "casa": "oficial",
  "nombre": "Oficial",
  "compra": 1490,
  "venta": 1540,
  "fechaActualizacion": "2026-10-02T18:55:00.000Z"
}

Ese JSON es lo que Nxar va a recibir en el body de la respuesta.

URL base y path

Una integración guarda una URL base, y cada llamada le puede sumar un path al final. Así, con una sola integración apuntando a https://dolarapi.com/v1/dolares, podés pedir /oficial, /blue o /tarjeta según lo que necesites. Es la forma de no crear una integración por cada recurso de la misma API.

Creá la integración

ConfiguraciónIntegraciones y APIIntegrations

Botón Nueva Integration. Completá:

Etiqueta: Cotización del dólar. Es el nombre que ve la gente.
Nombre: se completa solo a partir de la etiqueta, pero pierde las letras con tilde (queda algo como cotizaci_n_del_d_lar). Borralo y escribí cotizacion_dolar. Es el identificador con el que la vas a elegir en las automations, y no se puede cambiar después.
Método: GET.
URL: https://dolarapi.com/v1/dolares

Diálogo Nueva Integration con Etiqueta, Nombre cotizacion_dolar, Método GET y la URL de DolarApi — El Nombre se corrige a mano: el que se genera solo pierde las letras con tilde.

Hacé clic en Crear. Se abre la ficha de la integración.

Recorré la ficha

A la izquierda, tres bloques:

Configuración: etiqueta, descripción, método, URL y Headers por default.
Autenticación: el Tipo está en Ninguna. Para DolarApi está bien así.
Registro de llamadas: si se guarda o no cada llamada. Lo vemos en el capítulo de errores.

A la derecha, el bloque Test, para probarla sin salir de acá. Abajo de todo, Llamadas recientes.

Ficha de la integración Cotización del dólar con los bloques Configuración, Autenticación, Registro de llamadas y Test — La ficha recién creada: configuración a la izquierda, el probador a la derecha.

Probala

En Test, en Path (opcional) escribí /oficial y hacé clic en Ejecutar Test.

La llamada sale desde el servidor de Nxar, no desde tu navegador. En un par de segundos aparece el resultado: un 200 en verde, cuánto tardó, y el Body de respuesta con el JSON de la cotización.

Bloque Test con Path /oficial, resultado 200 en verde y el body con moneda, casa, compra y venta — Un 200 en verde y el JSON que devolvió la API: la integración funciona.

Guardá la respuesta como ejemplo

Debajo del resultado, Guardar como sample response. Nxar vuelve a hacer la llamada y guarda lo que recibe como respuesta de ejemplo de la integración.

Ese ejemplo no cambia cómo funciona la integración: sirve para que, al usarla en una automation, el builder conozca los campos de la respuesta (compra, venta, fechaActualizacion) y te los sugiera.

Probá también con Path /blue: la misma integración trae otra cotización. Y si dejás el Path vacío, la API devuelve una lista con todas las cotizaciones juntas.

Si al guardar el ejemplo la API devolvía una lista (por ejemplo, porque dejaste el Path vacío), el ejemplo guardado es una lista. Para este recorrido, guardalo con Path /oficial, así el ejemplo es un solo objeto.

Cómo saber que te salió

En Integrations aparece Cotización del dólar, con el método GET y su URL.
Ejecutar Test con Path /oficial devuelve 200 y un body con compra y venta.
Si salís y volvés a abrir la integración, el bloque Test muestra el Sample response guardado.

¿Llegaste al resultado de arriba?

En la referencia

Integraciones: crear y probar