航班在线值机链接 API

接入教程

1. 阅读授权指南获取访问令牌
2. 调用API接口提交航班信息
3. 接收并处理返回的值机链接
4. 在测试环境验证功能
5. 切换至生产环境部署

使用Python获取值机链接

python

import requests

# 设置请求参数
url = 'https://api.example.com/v2/check-in-links'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}
params = {
    'airlineCode': 'BA',
    'flightNumber': '123',
    'departureDate': '2024-01-01',
    'lastName': 'Doe'
}

# 发送请求
try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    data = response.json()
    print('Check-in link:', data.get('checkInLink'))
except requests.exceptions.RequestException as e:
    print('Error:', e)

使用PHP生成值机链接

php

<?php

$url = 'https://api.example.com/v2/check-in-links';
$apiKey = 'YOUR_API_KEY';
$queryParams = [
    'airlineCode' => 'AF',
    'flightNumber' => '456',
    'departureDate' => '2024-01-02',
    'lastName' => 'Smith'
];

$ch = curl_init($url . '?' . http_build_query($queryParams));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo 'Check-in link: ' . ($data['checkInLink'] ?? 'Not found');
}
curl_close($ch);

?>

使用JavaScript获取值机链接

javascript

const url = 'https://api.example.com/v2/check-in-links';
const params = new URLSearchParams({
  airlineCode: 'LH',
  flightNumber: '789',
  departureDate: '2024-01-03',
  lastName: 'Johnson'
});

fetch(`${url}?${params}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(response => {
  if (!response.ok) {
    throw new Error('Network response was not ok');
  }
  return response.json();
})
.then(data => {
  console.log('Check-in link:', data.checkInLink);
})
.catch(error => {
  console.error('Error:', error);
});

常见问题

该API是否需要授权？如何获取API密钥？

是的，该API需要授权。您需要先在开发者平台注册账号，创建应用以获取API密钥（YOUR_API_KEY），并遵循OAuth 2.0流程生成访问令牌。详情请参考官方授权指南。

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

测试环境基于生产环境的子集，数据可能不完整或为模拟数据，主要用于开发和集成测试，请勿用于生产。调用频率和可用性可能受限。

API返回的值机链接有效期是多久？

值机链接的有效期通常由航空公司策略决定，一般建议在航班起飞前24小时内使用。API返回的链接可能包含过期时间参数，请及时使用并参考航空公司规定。