Amadeus API

El componente Amadeus API permite a los usuarios de Nappai consultar información de viajes directamente desde la plataforma de Amadeus. Con él puedes buscar vuelos, hoteles, ubicaciones y actividades sin salir del dashboard.

¿Cómo funciona?

El componente se conecta a la API pública de Amadeus. Cuando lo añades a tu flujo, debes seleccionar la operación que deseas (vuelos, hoteles, ubicaciones o actividades) y proporcionar los parámetros necesarios (por ejemplo, origen y destino para vuelos). El componente envía una solicitud HTTP a Amadeus, recibe la respuesta y la devuelve como un objeto Data que puedes usar en los siguientes pasos de tu flujo.

Entradas

• Input
  Datos que se enviarán a la API. Puedes introducirlos como texto, como un objeto Data o como un mensaje. Si envías un JSON, el componente lo convierte automáticamente en la lista de parámetros que necesita.

• Api Selection
  Selecciona el tipo de búsqueda que quieres realizar.

  • Flight Offers Search: busca vuelos baratos.
  • Hotel Search: busca hoteles por ciudad.
  • Location Search: busca lugares por palabra clave.
  • Activity Search: busca actividades por coordenadas.

• Default Currency
  Moneda que se usará en los resultados (por defecto EUR).

• Default Language
  Idioma de la respuesta (por defecto en inglés).

Credencial
Este componente necesita una credencial llamada Amadeus Travel API.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial de tipo Amadeus Travel API.
2. Introduce tu Amadeus Client ID y Amadeus Client Secret.
3. En el componente, selecciona la credencial que acabas de crear en el campo Credential.

Salidas

• Data
  El resultado de la búsqueda se devuelve como un objeto Data.
  • Para vuelos, el objeto tendrá una lista bajo la clave flights.
  • Para hoteles, la clave será hotels.
  • Para ubicaciones, la clave será locations.
  • Para actividades, la clave será activities.
    Puedes usar esta salida en componentes posteriores, por ejemplo, para filtrar, ordenar o mostrar la información en un gráfico.

Ejemplo de Uso

Supongamos que quieres encontrar el vuelo más barato de Madrid a París el 15 de junio de 2025.

1. Añade el componente Amadeus API al flujo.

2. En Api Selection elige Flight Offers Search.

3. En Default Currency selecciona EUR y en Default Language deja en-US.

4. En Input escribe el siguiente JSON (puedes pegarlo directamente):

   {
     "origin": "MAD",
     "destination": "PAR",
     "depart_date": "2025-06-15"
   }

5. Conecta la salida Data a un componente de visualización (por ejemplo, un gráfico de tabla).

6. Ejecuta el flujo y verás una tabla con los vuelos disponibles, precios y horarios.

Componentes Relacionados

• Nappai Base Component – Base sobre la que se construyen todos los componentes de Nappai.
• Data – Tipo de dato que se utiliza para pasar información entre componentes.
• Message – Tipo de dato que permite enviar mensajes de texto entre componentes.

Consejos y Mejores Prácticas

• Revisa la documentación de Amadeus para conocer los límites de uso y las mejores prácticas de búsqueda.
• Usa credenciales seguras: nunca compartas tu Client ID y Client Secret en el flujo.
• Filtra los resultados: si la respuesta contiene muchos vuelos, utiliza un componente de filtrado antes de visualizarlos.
• Prueba con datos de ejemplo antes de usar datos reales para evitar llamadas innecesarias a la API.

Consideraciones de Seguridad

• La credencial Amadeus Travel API debe guardarse con permisos restringidos.
• Evita exponer la credencial en logs o en la interfaz de usuario.
• Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial o crea una nueva credencial específica para ese flujo.