Saltearse al contenido

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/pedidos y 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

CampoQué hace
URL (obligatorio)La dirección que se consulta con GET, por ejemplo https://api.ejemplo.com/v1/pedidos?estado=nuevo.
Items PathDónde está la lista dentro de la respuesta, con puntos: data.items. Vacío si la respuesta ya es la lista.
ID FieldEl 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.
DataSirve para probar el componente: pega aquí un ejemplo de lo que llega y ejecuta el flujo para ver el resultado.

Opciones avanzadas

CampoQué hace
HeadersCabeceras que se envían en cada consulta, como un objeto JSON: {"Authorization": "Bearer …"}. Se guardan con el flujo.
Max Items per RunCuántos elementos como máximo llegan en cada ejecución (1–100, por defecto 20).
Process Existing ItemsSi 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

  1. Despliega una versión del flujo. Ver Versiones y publicación.
  2. En el componente, pulsa Activar. Se abre la ventana Acceso a API en la pestaña Disparadores de elementos nuevos.
  3. 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é.
  4. 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 GET a direcciones http y https pú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