Tours and Activities API

接入教程

1. 注册Amadeus开发者账号并创建应用
2. 阅读授权指南获取访问令牌
3. 使用测试环境调用API端点
4. 集成活动搜索和预订功能
5. 切换至生产环境部署应用

Python请求示例：获取旅游活动列表

python

import requests

# 设置API基础URL和认证信息
base_url = 'https://api.example.com'
api_key = 'YOUR_API_KEY'

# 请求头
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

# 请求参数示例
params = {
    'cityCode': 'PAR',
    'startDate': '2024-06-01',
    'endDate': '2024-06-10',
    'maxResults': 10
}

# 发送GET请求
try:
    response = requests.get(f'{base_url}/tours', headers=headers, params=params)
    response.raise_for_status()
    data = response.json()
    print('成功获取活动列表:', data)
except requests.exceptions.RequestException as e:
    print('请求失败:', e)

PHP请求示例：查询景点详情

php

<?php

// API配置
$baseUrl = 'https://api.example.com';
$apiKey = 'YOUR_API_KEY';

// 设置请求头
$headers = [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
];

// 构建请求URL
$activityId = 'ACT12345';
$url = $baseUrl . '/activities/' . $activityId;

// 初始化cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

// 执行请求
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo '请求错误: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo '活动详情: ' . print_r($data, true);
}
curl_close($ch);

?>

JavaScript请求示例：搜索旅游活动

javascript

// API配置
const baseUrl = 'https://api.example.com';
const apiKey = 'YOUR_API_KEY';

// 搜索参数
const searchParams = {
    keyword: 'museum',
    cityCode: 'NYC',
    category: 'cultural',
    page: 1,
    pageSize:   20
};

// 构建请求URL
const queryString = new URLSearchParams(searchParams).toString();
const url = `${baseUrl}/search?${queryString}`;

// 发送请求
fetch(url, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
})
.then(data => {
    console.log('搜索结果:', data);
})
.catch(error => {
    console.error('请求失败:', error);
});

常见问题

如何获取API访问密钥？

请访问开发者门户网站注册账户并创建应用，在应用详情页可获取API密钥。测试环境密钥与生产环境不同，请根据需求分别申请。

API请求频率限制是多少？

测试环境每分钟最多100次请求，生产环境根据订阅套餐不同，从每分钟500次到5000次不等。超出限制会返回429状态码，建议合理控制请求频率。

支持哪些数据返回格式？

API默认返回JSON格式数据，支持通过Accept请求头指定返回格式。目前仅支持JSON格式，未来可能会支持XML格式。所有响应都包含标准HTTP状态码。