GUÍA DEL PROYECTO · PHP + APIS DE VIAJE

Todo el viaje.
Un solo playground.

Consulta vuelos, hoteles y respuestas originales de varios proveedores desde una interfaz local. Esta guía te lleva desde la configuración inicial hasta la primera búsqueda.

Ir al playground Ver configuración

Claves protegidas en PHP Resultados y JSON original Entorno local primero

4proveedores en el catálogo

12operaciones explorables

1interfaz de pruebas

Las operaciones muestran su estado real. Juniper figura como integración pendiente.

01 / INTEGRACIONES

Qué puedes probar

Cada proveedor conserva su contrato propio. El panel te muestra parámetros, resultados resumidos y la respuesta completa.

AIntegrado

Amadeus

Autenticación OAuth2, búsqueda de ofertas de vuelo e inspiración de destinos.

flight-offersflight-destinations

Confirma el acceso vigente: el host de pruebas anterior no resolvió en la última verificación.

HIntegrado

Hotelbeds

Disponibilidad de habitaciones, verificación de tarifa y confirmación de reservas.

hotelscheckratesbookings

Disponibilidad y CheckRates se probaron localmente. La reserva requiere confirmación.

SIntegrado

SerpApi

Resultados de Google Flights y Google Hotels, regreso, opciones de compra y detalle de hotel.

google_flightsgoogle_hotels

Las opciones de compra enlazan a terceros; no crean reservas.

JPendiente

Juniper

El catálogo explica el flujo previsto. Falta conectar el Web Service XML y configurar el contrato.

disponibilidadreglasreserva

No se muestran resultados simulados como si fueran reales.

02 / CONFIGURACIÓN

De cero a la primera consulta

Solo necesitas PHP con cURL y las credenciales de los proveedores que quieras probar.

Prepara el entorno

Usa PHP 8.1 o superior con la extensión cURL. Si todavía no tienes .env, cópialo desde .env.example en la raíz del proyecto.

Configura las claves

Rellena solo las credenciales que vas a utilizar. PLAYGROUND_PASSWORD protege el panel; las claves de proveedores nunca se escriben en el navegador.

Inicia el servidor

Ejecuta el comando desde la raíz travelapis y abre la dirección local. La carpeta pública debe ser public/.

PowerShell · travelapis

# Solo si aún no existe .env

PS> Copy-Item .env.example .env

# Completa .env con tus credenciales

PS> php -S 127.0.0.1:8089 -t public

✓ http://127.0.0.1:8089/

Variables principalesPLAYGROUND_PASSWORDAMADEUS_CLIENT_IDAMADEUS_CLIENT_SECRETHOTELBEDS_API_KEYHOTELBEDS_SECRETSERPAPI_API_KEY

Configuración local: si habilitas PLAYGROUND_LOCAL_AUTOLOGIN=1, el acceso automático solo funciona desde 127.0.0.1 o localhost. En el VPS usa PLAYGROUND_LOCAL_AUTOLOGIN=0, HTTPS y una contraseña propia.

03 / USO DIARIO

Cómo trabajar en el panel

El recorrido es el mismo para cada integración, con seguimiento guiado cuando una respuesta incluye tokens o referencias.

Elige una operación

Selecciona proveedor y endpoint en el menú lateral. El panel indica qué hace y qué campos necesita.

Ejecuta la consulta

Completa origen, destino, fechas o la referencia solicitada. Las peticiones salen desde PHP hacia el proveedor.

Inspecciona y continúa

Compara el resumen con el JSON original. Usa los botones de seguimiento para regreso, hotel o tarifa.

Antes de confirmar una reserva

La operación Hotelbeds bookings puede crear una reserva en el entorno configurado. El panel pide escribir RESERVAR y confirmar una segunda vez.

LISTO PARA TU VPS

Publica la carpeta correcta.

Configura el document root del sitio en travelapis/public. Crea un .env nuevo en la raíz, fuera de esa carpeta pública. Habilita HTTPS y desactiva el acceso automático local.

Abrir playground

Todo el viaje.Un solo playground.