Saltearse al contenido
Nappai Documentation

Amadeus Api Toolkit

El Amadeus Api Toolkit te permite integrar fácilmente los servicios de Amadeus Travel en tus flujos de trabajo de Nappai. Con él puedes elegir qué herramientas de búsqueda (ciudad, vuelo, hotel, ubicación, actividad o aeropuerto) quieres usar, establecer la moneda y el idioma por defecto, y obtener un conjunto de herramientas listas para ser consumidas por otros componentes.

¿Cómo funciona?

Cuando configuras el componente, seleccionas los nombres de las herramientas que necesitas. El componente crea un cliente de Amadeus para cada herramienta elegida, usando tu Amadeus Client ID y Amadeus Client Secret que ya has guardado en la sección de credenciales de Nappai. Cada cliente se inicializa con la moneda y el idioma que hayas elegido. Finalmente, el componente devuelve un GenericToolKit que contiene todas las herramientas seleccionadas, listo para ser usado por otros componentes que requieran acceso a la API de Amadeus.

Entradas

El componente incluye un campo especial llamado Credential donde debes seleccionar la credencial Amadeus Travel API que configuraste previamente en Nappai.
Los campos de entrada que puedes configurar son:

  • Default Currency: Selecciona la moneda que se usará por defecto en las peticiones a la API.
  • Default Language: Selecciona el idioma que se usará por defecto en las respuestas de la API.
  • Selected Tools: Elige las herramientas de Amadeus que quieres incluir en el toolkit (por ejemplo, City Search, Flight Search, Hotel Search, Location Search, Activity Search, Airport Search).

Salidas

  • BaseToolkit: Un objeto BaseToolkit que contiene todas las herramientas seleccionadas. Este toolkit puede ser pasado a otros componentes que necesiten realizar búsquedas de vuelos, hoteles, etc.

Ejemplo de Uso

  1. Configura la credencial

    • Ve a la sección de credenciales de Nappai y crea una credencial llamada Amadeus Travel API con tu Client ID y Client Secret.
    • En el componente, selecciona esa credencial en el campo Credential.

  2. Configura el componente

    • En Selected Tools elige Flight Search y Hotel Search.
    • En Default Currency selecciona USD.
    • En Default Language selecciona en-US.

  3. Utiliza el toolkit

    • Conecta la salida BaseToolkit a otro componente que necesite buscar vuelos o hoteles.
    • El flujo de trabajo podrá usar las herramientas incluidas para obtener resultados de Amadeus sin escribir código adicional.

Componentes Relacionados

  • GenericToolKit: El contenedor que agrupa las herramientas creadas por este componente.
  • AmadeusFlightSearchTool / AmadeusHotelSearchTool / AmadeusCitySearchTool: Herramientas específicas que se incluyen según la selección.

Consejos y Mejores Prácticas

  • Reutiliza la credencial: Una vez creada la credencial Amadeus Travel API, úsala en todos los componentes que necesiten acceder a Amadeus para evitar duplicar información sensible.
  • Limita las herramientas: Selecciona solo las herramientas que realmente necesites; cada herramienta adicional aumenta la complejidad y el tiempo de inicialización.
  • Moneda y idioma coherentes: Mantén la misma moneda y idioma en todo tu flujo de trabajo para evitar confusiones en los resultados mostrados.
  • Prueba con datos de ejemplo: Antes de usar el toolkit en producción, prueba las búsquedas con datos de prueba para asegurarte de que la configuración es correcta.

Consideraciones de Seguridad

  • Protege tus credenciales: La credencial Amadeus Travel API contiene información sensible. No la compartas y asegúrate de que solo usuarios autorizados tengan acceso a ella.
  • Registra el uso: Si tu organización necesita auditoría, registra cuándo y cómo se utilizan las herramientas de Amadeus para cumplir con las políticas internas.