HTTP New Item
HTTP New Item es un componente de inicio: convierte en disparador cualquier servicio sin webhooks que tenga una dirección que devuelva una lista en JSON. Una vez activado, NappAI consulta esa dirección cada cierto tiempo, localiza la lista dentro de la respuesta y ejecuta el flujo con los elementos que no había visto antes.
Cuándo usarlo
- Una aplicación interna publica sus pedidos en
https://api.ejemplo.com/v1/pedidosy no avisa de los nuevos. - Un portal de licitaciones o de empleo ofrece sus resultados en JSON y quieres reaccionar a cada uno nuevo.
- Quieres vigilar un servicio que solo permite consultar, no suscribirse.
Configuración
| Campo | Qué hace |
|---|---|
| URL (obligatorio) | La dirección que se consulta con GET, por ejemplo https://api.ejemplo.com/v1/pedidos?estado=nuevo. |
| Items Path | Dónde está la lista dentro de la respuesta, con puntos: data.items. Vacío si la respuesta ya es la lista. |
| ID Field | El campo que identifica cada elemento, por ejemplo id (admite puntos: pedido.numero). Vacío: se compara el elemento entero, así que cualquier cambio en él lo hace llegar de nuevo. Por defecto, id. Si ningún elemento tiene ese campo, el nodo da un error con los campos que sí tienen. |
| Data | Sirve para probar el componente: pega aquí un ejemplo de lo que llega y ejecuta el flujo para ver el resultado. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Headers | Cabeceras que se envían en cada consulta, como un objeto JSON: {"Authorization": "Bearer …"}. Se guardan con el flujo. |
| Max Items per Run | Cuántos elementos como máximo llegan en cada ejecución (1–100, por defecto 20). |
| Process Existing Items | Si lo activas, también llegan los elementos que la dirección ya devolvía al activar el disparador. |
| Check Every (seconds) | Cada cuántos segundos se consulta (de 60 a 86.400; por defecto 300). |
Activar el disparador
- Despliega una versión del flujo. Ver Versiones y publicación.
- En el componente, pulsa Activar. Se abre la ventana Acceso a API en la pestaña Disparadores de elementos nuevos.
- Pulsa Activar. NappAI consulta la dirección, comprueba que devuelve JSON y que en Items Path hay una lista, y memoriza los elementos actuales. Si algo falla, el aviso dice qué.
- Para dejar de escuchar, pulsa Desactivar.
Resultado
La salida Data devuelve un elemento por cada elemento nuevo de la lista, con sus propios campos, en el orden en que los devuelve la API.
Buenas prácticas
- Elige un ID Field que no cambie: el identificador del registro, no su estado ni su fecha de modificación.
- Si la API pagina, consulta la página donde aparecen los más recientes (por ejemplo, ordenados por fecha de creación descendente).
- Guarda las claves de la API en una credencial siempre que el servicio tenga componente propio; Headers queda guardado dentro del flujo.
Seguridad
- Solo consultas
GETa direccioneshttpyhttpspúblicas: las de la red interna o las de metadatos del servidor se rechazan, también tras una redirección. - Las respuestas de más de 5 MB se descartan y cada consulta tiene un tiempo máximo de 20 segundos.
Componentes relacionados
- RSS New Item: entradas nuevas de un feed RSS o Atom.
- API Request: para llamar a una API dentro del flujo, no como disparador.
- MySQL New Row y PostgreSQL New Row: filas nuevas de una base de datos.