酒店预订API

接入教程

1. 阅读授权指南获取访问令牌
2. 注册开发者账号并获取API密钥
3. 配置测试环境连接
4. 调用酒店搜索接口获取列表
5. 使用预订接口完成订单
6. 在生产环境中部署应用

Python示例：搜索酒店

python

import requests

# API配置
BASE_URL = 'https://api.example.com'
API_KEY = 'YOUR_API_KEY'

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

# 搜索参数
search_params = {
    'city': 'Beijing',
    'check_in': '2024-12-01',
    'check_out': '2024-12-03',
    'adults': 2
}

# 发送请求
try:
    response = requests.get(
        f'{BASE_URL}/hotels/search',
        headers=headers,
        params=search_params
    )
    response.raise_for_status()
    hotels = response.json()
    print(f'找到 {len(hotels)} 家酒店')
except requests.exceptions.RequestException as e:
    print(f'请求失败: {e}')

PHP示例：获取酒店详情

php

<?php

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

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

// 酒店ID
$hotelId = 'HOTEL123';

// 初始化cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . '/hotels/' . $hotelId);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 发送请求
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo '请求失败: ' . curl_error($ch);
} else {
    $hotelData = json_decode($response, true);
    echo '酒店名称: ' . ($hotelData['name'] ?? '未知');
}

curl_close($ch);
?>

JavaScript示例：创建预订

javascript

// API配置
const BASE_URL = 'https://api.example.com';
const API_KEY = 'YOUR_API_KEY';

// 预订数据
const bookingData = {
  hotel_id: 'HOTEL456',
  room_type: 'standard',
  check_in: '2024-12-01',
  check_out: '2024-12-03',
  guests: [
    { name: '张三', age: 30 }
  ]
};

// 发送请求
fetch(`${BASE_URL}/bookings`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(bookingData)
})
.then(response => {
  if (!response.ok) {
    throw new Error(`HTTP错误: ${response.status}`);
  }
  return response.json();
})
.then(data => {
  console.log('预订成功，编号:', data.booking_id);
})
.catch(error => {
  console.error('预订失败:', error.message);
});

常见问题

如何获取API访问令牌？

请参考官方授权指南获取访问令牌，测试环境使用生产数据的子集，需要申请测试密钥。

API支持哪些预订功能？

该API提供酒店搜索、详情查询、价格检查、预订创建和订单管理等功能，具体端点请查看完整文档。

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

测试环境基于生产数据的子集，主要用于开发和集成测试，不支持真实交易，响应数据可能受限。