Cómo buscar aeropuertos usando Autocompletar
El punto final de autocompletar es el primer paso en el flujo de reserva de la API de vuelos. Úselo para resolver nombres de aeropuertos o códigos IATA en datos estructurados de aeropuertos. Los encabezados de respuesta incluyen un x-correlation-id que debe capturar y pasar a todas las llamadas API posteriores.
Punto final
GET /flights/api/v2/autocomplete?key={search_term}
encabezados
| Encabezado | Requerido | Descripción |
|---|---|---|
x-api-key | Sí | Su clave API. |
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
key | cadena | Sí | Nombre del aeropuerto, nombre de la ciudad o código IATA a buscar. Se recomienda un mínimo de 2 caracteres. |
Solicitud de ejemplo
GET /flights/api/v2/autocomplete?key=SFO
Ejemplo de respuesta
JSON
{
"status": "success",
"data": [
{
"airport_code": "SFO",
"airport_name": "San Francisco International Airport",
"city_code": "SFO",
"city_name": "San Francisco",
"country_code": "US",
"country_name": "United States"
}
],
"message": "Airports retrieved successfully"
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
status | cadena | Estado de la solicitud (success o error). |
data | matriz | Lista de objetos aeroportuarios coincidentes. |
data[].airportcode | cadena | Código de aeropuerto IATA (por ejemplo, SFO). |
data[].airportname | cadena | Nombre completo del aeropuerto. |
data[].citycode | cadena | Código de ciudad IATA. |
data[].cityname | cadena | Nombre de la ciudad. |
data[].countrycode | cadena | Código ISO de país. |
data[].countryname | cadena | Nombre completo del país. |
message | cadena | Mensaje de estado legible por humanos. |
Capturando el ID de correlación
La respuesta de autocompletar incluye un x-correlation-id en los encabezados de respuesta. Debe capturar este valor e incluirlo como encabezado en todas las solicitudes posteriores (búsqueda, disponibilidad, reglas de tarifas y reserva).
Response Headers:
x-correlation-id: abc123-def456-ghi789
Almacene este valor y páselo como:
x-correlation-id: abc123-def456-ghi789
en los encabezados de su próxima llamada API.
Respuestas de error
| Estado HTTP | Descripción |
|---|---|
| 400 | Parámetro key no válido o faltante. |
| 500 | Error Interno del Servidor. Vuelva a intentar la solicitud o comuníquese con el soporte. |
Consejos
- Busque por código IATA (por ejemplo,
SFO,LAX,BLR) para obtener los resultados más precisos. - Busque por nombre de ciudad (por ejemplo,
San Francisco,London) para devolver todos los aeropuertos de esa ciudad. - Imprescindible el
x-correlation-id. Sin él, el punto final de búsqueda rechazará su solicitud.
Próximos pasos
- Cómo buscar vuelos: utilice los códigos de aeropuerto y el ID de correlación para buscar vuelos.