Saltar al contenido
Blog

La mejor API de reserva de vuelos: antes, di qué estás construyendo

Redacción de Tekravel
Escrito con la ayuda de IA

El encargo dice: encontrar la mejor API de reserva de vuelos. Abres tres páginas de comparativas y las tres ordenan los mismos nombres de tres maneras distintas, cada uno con su cuadrícula de marcas de verificación. Al llegar a la tercera notas lo que ninguna preguntó: qué le pasa al cliente después de que vuelven los resultados de búsqueda.

Esa pregunta ausente es toda la respuesta. La mejor API de reserva de vuelos para una página que manda al visitante a la web de la aerolínea es una mala elección para un sitio que cobra la reserva con tarjeta. Y ninguna de las dos es la adecuada para la herramienta interna que el personal de una agencia usará todo el día. Buscar, tarificar y reservar se ven igual en cualquier documentación. Lo que cambia está debajo, y cuál de esas diferencias te hará daño depende por completo del producto.

Tres productos que todos llaman «web de reservas de vuelos»

El primero es una página de comparación o inspiración: muestra tarifas, enlaza fuera y nunca toca el billete. Aquí la API es casi solo búsqueda. Importa lo amplios y recientes que sean los resultados, y que el precio mostrado se parezca al que verá el visitante al llegar. Tu sistema nunca tiene que anular, reembolsar ni reemitir nada, así que la fortaleza de un proveedor en eso se desperdicia contigo.

El segundo vende. El visitante te paga, tú reservas, y desde ese momento eres dueño de un ciclo de vida de la reserva: confirmar el precio antes de cobrar, tratar con una aerolínea que responde lento, anular el mismo día, reembolsar después, reemitir cuando el cliente cambia la fecha. Para este producto la búsqueda es la parte fácil. Las propiedades que deciden la elección vienen después.

El tercero es la herramienta propia de una agencia, usada por personal que ya tiene relaciones con proveedores. La búsqueda en bruto no es el punto. Importa que aparezca el contenido negociado por la agencia, que los subagentes tengan límites de crédito, que el margen se aplique antes de que nadie vea un precio y que a fin de mes existan informes. Una API excelente para el segundo producto puede seguir siendo la base equivocada aquí.

Conviene decirlo sin rodeos: la misma API no puede ser la mejor en los tres. Si un ranking afirma que sí, no se ha topado con el segundo.

Las propiedades que merece la pena comparar, y quién depende de ellas

Reduce la cuadrícula a las filas sobre las que un desarrollador podría discrepar de verdad. Cada producto se apoya en un subconjunto distinto, y el resto puedes ignorarlo sin problema.

PropiedadPágina de redirecciónVende y cobraHerramienta del personal
Cuánto puede envejecer un precio mostrado antes de confirmarseImporta pocoDecisivo: cobras sobre élImporta: el personal cotiza con él
Qué devuelve una reserva cuando la aerolínea tardaNo aplicaDecisivoImporta
Quién puede anular y reembolsar, y cómo se solicitaNo aplicaDecisivoDecisivo
Cómo se resuelve una reserva de resultado desconocidoNo aplicaDecisivo: la tarjeta puede estar ya cobradaImporta
Si se aplican el contenido propio de la agencia y sus reglas de créditoNo aplicaA vecesDecisivo
En qué se distingue el comportamiento de pruebas del realBajoAltoAlto

Lee tu columna e ignora las demás. El error que cuesta dinero es leer la columna de la página de redirección porque es la más fácil de evaluar, y construir el segundo producto.

El precio que muestras aún no es el que cobras

Toma el segundo producto y sigue una tarifa a través de él. La búsqueda devuelve un precio. El visitante lo mira, lo piensa, abre otra pestaña y vuelve. Un rato después pulsa el botón. Entre la búsqueda y el botón la tarifa ha estado guardada en tu sistema, y la única pregunta honesta sobre cualquier API es qué dirá cuando le preguntes de nuevo en ese momento.

Un proveedor puede dar tres respuestas. Puede confirmar el precio que mostraste. Puede devolver un precio nuevo, y tu código debe decidir si cobra la diferencia, pregunta al cliente o se detiene. O puede decir que la tarifa ya no existe. Un sitio que solo ha previsto la primera respuesta funcionará en todas las demos y fallará en las semanas siguientes, y fallará de una forma que cuesta dinero en lugar de lanzar errores.

Así que la pregunta de diseño no es si la API tiene un paso de confirmación de precio. Casi todas lo tienen. Es cómo se ve la respuesta en los tres desenlaces y si tu código puede distinguirlos sin adivinar. Pide un ejemplo de cada uno. Un proveedor que puede mostrarte el segundo y el tercero en su documentación ha pensado en tu producto. Uno que solo muestra el primero ha pensado en la demo.

La prueba de una tarde que ninguna cuadrícula te da

Sea cual sea la lista corta, ejecuta la misma prueba breve con cada nombre, y con los fallos provocados a propósito. Reserva algo y mira qué conserva el objeto de reserva una vez emitido. Tarifica el mismo itinerario dos veces, con minutos de diferencia, y observa cómo se relaciona la segunda respuesta con la primera. Cancela, pide el reembolso y anota quién tiene que actuar. Después haz al proveedor dos preguntas por escrito: qué devuelve su sistema cuando una aerolínea agota el tiempo en plena reserva, y cómo averiguo qué ocurrió de verdad.

Las respuestas escritas valen más que la demo. Un proveedor con un procedimiento claro para un resultado desconocido ya se ha topado con el problema. Uno que responde con el nombre de una función, no.

Para armar el plan de pruebas en sí, el plan de sandbox repasa lo que el sandbox no te mostrará. Y si comparas proveedores por lo que hay detrás de la API y no por la API, es otra pregunta con su propio artículo; este se queda en el producto.

Lo que pagas si eliges por la lista de endpoints

Los fallos son silenciosos. Un sitio confirma los precios tarde y la diferencia entre la tarifa mostrada y la real sale de tu margen, reserva a reserva. Una reserva queda en estado desconocido con la tarjeta del cliente ya cobrada, y alguien tiene que resolverlo a mano, normalmente por correo y normalmente en fin de semana. Una herramienta construida sobre contenido solo de búsqueda resulta que el personal no puede emitir desde ella, y el proyecto se rehace con otro contenido.

Nada de esto se ve en una cuadrícula de marcas. Todo se veía en la primera columna de la tabla de arriba, antes de escribir una línea de código.

Nuestra postura es más estrecha de lo que permitiría un ranking. Tekravel ofrece APIs de vuelos y hoteles, el acceso empieza con una conversación y no con una clave de autoservicio, los servicios se activan por inquilino y el contenido de proveedores llega a cada inquilino mediante grupos de proveedores. Eso encaja con el segundo y el tercer producto. Si construyes el primero, quizá no nos necesites. Si construyes alguno de los otros, la página de la API es el lugar para empezar la conversación.

Redacción de Tekravel

Mesa de tecnología de viajes

La mesa de tecnología de viajes de Tekravel escribe para el sector: propietarios de agencias, consolidadores y los desarrolladores que los integran. Cada artículo se comprueba contra la plataforma que describe antes de publicarse.