航班灵感搜索

接入教程

1. 阅读授权指南生成访问令牌
2. 调用API端点进行航班灵感搜索
3. 处理返回的旅行目的地数据
4. 集成到您的应用或网站中
5. 在测试环境中验证功能
6. 根据需求调整搜索参数

Python示例：搜索航班灵感

python

import requests

# 设置API端点
url = "https://api.example.com/v1/shopping/flight-destinations"
params = {
    "origin": "LON",
    "departureDate": "2024-07-01",
    "oneWay": False,
    "maxPrice": 200
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

# 发送请求
try:
    response = requests.get(url, params=params, headers=headers)
    response.raise_for_status()
    data = response.json()
    print(f"找到 {len(data.get('data', []))} 条航班信息")
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")

PHP示例：获取航班目的地

php

<?php

$url = "https://api.example.com/v1/shopping/flight-destinations";
$params = [
    'origin' => 'PAR',
    'departureDate' => '2024-08-15',
    'oneWay' => true,
    'maxPrice' => 150
];
$query = http_build_query($params);
$fullUrl = $url . '?' . $query;

$options = [
    'http' => [
        'header' => "Authorization: Bearer YOUR_API_KEY\r\n",
        'method' => 'GET'
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($fullUrl, false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    echo "找到 " . count($data['data'] ?? []) . " 个目的地\n";
} else {
    echo "请求失败\n";
}

?>

JavaScript示例：航班灵感搜索

javascript

const fetch = require('node-fetch');

async function searchFlightInspiration() {
    const url = new URL('https://api.example.com/v1/shopping/flight-destinations');
    const params = {
        origin: 'NYC',
        departureDate: '2024-09-10',
        oneWay: false,
        maxPrice: 300
    };
    
    Object.keys(params).forEach(key => 
        url.searchParams.append(key, params[key])
    );
    
    try {
        const response = await fetch(url, {
            headers: {
                'Authorization': 'Bearer YOUR_API_KEY'
            }
        });
        
        if (!response.ok) {
            throw new Error(`HTTP错误: ${response.status}`);
        }
        
        const data = await response.json();
        console.log(`找到 ${data.data?.length || 0} 个航班选项`);
    } catch (error) {
        console.error('请求失败:', error.message);
    }
}

searchFlightInspiration();

常见问题

如何获取API访问令牌？

请参考官方授权指南生成访问令牌。测试环境使用生产数据的子集，建议先阅读文档了解认证流程。

API支持哪些查询参数？

支持出发地、日期、单程/往返、价格上限等参数。具体参数请参考API文档的端点说明部分。

测试环境和生产环境有什么区别？

测试环境基于生产数据的子集，主要用于开发和测试。生产环境包含完整数据，需要正式授权才能访问。