淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
create_order_request	CreateOrderRequest	必须			请求入参
└ chd_build_fee Number 可选 50 儿童机建费 └ inf_flight_item_price Number 可选 100 婴儿机票商品价格 └ total_price Number 必须 950 订单总价(单位：元) └ adt_build_fee Number 必须 50 成人机建费 └ out_order_no String 必须 1234324786812 外部订单号 └ chd_total_fee Number 可选 90 每位儿童的总税费 contact Contact 必须联系人 └ credential_type Number 可选 0 证件类型 (0, "身份证"), (1, "护照"), (2, "学生证"), (3, "军人证"), (4, "回乡证"), (5, "台胞证"), (6, "港澳通行证"), (7, "国际海员"), (8, "外国人永久居留证"), (10, "警官证"), (11, "士兵证"), (12, "台湾通行证"), (13, "入台证"), (14, "户口簿"), (15,"出生证明"), (16,"驾照"), (17, "港澳居民居住证"), (18, "台湾居民居住证") └ mobile_phone_number String 必须 13512344321 联系人手机号码(无国家码部分) └ credential_no String 可选 110101199003076712 证件号 └ mobile_country_code String 必须 86 联系人手机国家码 └ phone String 可选 043112345556 联系人电话 └ name String 必须张三联系人姓名 └ email String 可选 111111111111@qq.com 联系人邮箱 └ adt_flight_item_price Number 必须 500 成人的机票价格 └ adt_oil_fee Number 必须 40 成人燃油价格 passenger_list Passenger [] 必须乘机人 └ birthday Date 必须 2001-08-22 00:00:00 yyyy-MM-dd └ credential_type Number 必须 0 证件类型 (0, "身份证"), (1, "护照"), (2, "学生证"), (3, "军人证"), (4, "回乡证"), (5, "台胞证"), (6, "港澳通行证"), (7, "国际海员"), (8, "外国人永久居留证"), (10, "警官证"), (11, "士兵证"), (12, "台湾通行证"), (13, "入台证"), (14, "户口簿"), (15,"出生证明"), (16,"驾照"), (17, "港澳居民居住证"), (18, "台湾居民居住证")。乘机人会员商品时所有成人的证件类型必须是身份证或户口本，否则必生单失败 └ mobile_phone_number String 必须 13512344321 乘机人手机号码(无国家码部分) └ credential_no String 必须 110101199003072770 证件号 └ mobile_country_code String 必须 86 手机号-国家码 └ name String 必须李四乘机人姓名 └ type Number 必须 0 乘客类型 ADT(0, "普通成人"), CHD(1, "儿童"), INFANT(8, "婴儿") └ given_name String 可选 SI 名，英文/拼音 └ middle_name String 可选 BEAN 中间名，英文/拼音 └ surname String 可选 LI 姓，英文/拼音 └ nationality String 可选 CN 国籍-二字码 └ gender Number 可选 0 性别 MALE(0, "男"), FEMALE(1, "女") └ credential_issue_place String 可选 CN 证件签发地 └ credential_expire_date Date 可选 2025-01-01 00:00:00 证件到期时间 └ chd_flight_item_price Number 可选 300 儿童机票商品价格 └ chd_oil_fee Number 可选 40 儿童燃油费 └ item_id String 必须 77153a888b024ebebd8d5bf8d0db20f7_0 商品id └ adt_total_fee String 必须 90 每位成人的总税费(单位：元) └ channel_name String 必须 feiye 接入方提供的用户名 └ allow_register_or_query_member Boolean 可选 true 是否允使用下单信息注册或查询会员。是会员商品(search接口返回的passenger_restrict.member_restrict不为空)时，必须填入true，否则必生单失败！ member_buyer MemberBuyer 可选购买人信息,购买人会员商品必传 └ name_zh String 可选张三购买人姓名,中文。购买人会员商品时，该字段必填，否则生单失败！ └ family_name_zh String 可选张购买人姓,中文。购买人会员商品时，该字段必填，否则生单失败！ └ given_name_zh String 可选三购买人名,中文。购买人会员商品时，该字段必填，否则生单失败！ └ family_name_en String 可选 ZHANG 购买人姓,英文(拼音请全大写)。购买人会员商品时，该字段必填，否则生单失败！ └ given_name_en String 可选 SAN 购买人名,英文(拼音请全大写)。购买人会员商品时，该字段必填，否则生单失败！ └ phone String 可选 18457890380 购买人联系电话。购买人会员商品时，该字段必填，否则生单失败！ └ id_card_no String 可选 455456733456780981 购买人身份证号。购买人会员商品时，该字段必填，否则生单失败！ └ gender Number 可选 0 购买人性别。0:男;1:女

名称	类型	示例值	描述
order_id	Number	4123543523452345	订单id
is_success	Boolean	true	请求是否成功
error_code_info	String	isv.SYSTEM_ERROR	错误码
error_msg	String	系统错误	错误描述
order_status	String	BOOK_SUCCEEDED	订单状态 CREATING("生单预定处理中"), BOOK_SUCCEEDED("生单预定成功"), PAID("订单已支付"), SUCCEEDED("订单成功"), CLOSED("订单关闭")
out_order_no	String	1234324786812	外部订单号

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightServiceAirbookRequest req = new AlitripFlightServiceAirbookRequest();
AlitripFlightServiceAirbookRequest.CreateOrderRequest obj1 = new AlitripFlightServiceAirbookRequest.CreateOrderRequest();
obj1.setChdBuildFee(50L);
obj1.setInfFlightItemPrice(100L);
obj1.setTotalPrice(950L);
obj1.setAdtBuildFee(50L);
obj1.setOutOrderNo("1234324786812");
obj1.setChdTotalFee(90L);
AlitripFlightServiceAirbookRequest.Contact obj2 = new AlitripFlightServiceAirbookRequest.Contact();
obj2.setCredentialType(0L);
obj2.setMobilePhoneNumber("13512344321");
obj2.setCredentialNo("110101199003076712");
obj2.setMobileCountryCode("86");
obj2.setPhone("043112345556");
obj2.setName("张三");
obj2.setEmail("111111111111@qq.com");
obj1.setContact(obj2);
obj1.setAdtFlightItemPrice(500L);
obj1.setAdtOilFee(40L);
List<AlitripFlightServiceAirbookRequest.Passenger> list4 = new ArrayList<AlitripFlightServiceAirbookRequest.Passenger>();
AlitripFlightServiceAirbookRequest.Passenger obj5 = new AlitripFlightServiceAirbookRequest.Passenger();
list4.add(obj5);
obj5.setBirthday(StringUtils.parseDateTime("2001-08-22 00:00:00"));
obj5.setCredentialType(0L);
obj5.setMobilePhoneNumber("13512344321");
obj5.setCredentialNo("110101199003072770");
obj5.setMobileCountryCode("86");
obj5.setName("李四");
obj5.setType(0L);
obj5.setGivenName("SI");
obj5.setMiddleName("BEAN");
obj5.setSurname("LI");
obj5.setNationality("CN");
obj5.setGender(0L);
obj5.setCredentialIssuePlace("CN");
obj5.setCredentialExpireDate(StringUtils.parseDateTime("2025-01-01 00:00:00"));
obj1.setPassengerList(list4);
obj1.setChdFlightItemPrice(300L);
obj1.setChdOilFee(40L);
obj1.setItemId("77153a888b024ebebd8d5bf8d0db20f7_0");
obj1.setAdtTotalFee("90");
obj1.setChannelName("feiye");
obj1.setAllowRegisterOrQueryMember(true);
AlitripFlightServiceAirbookRequest.MemberBuyer obj6 = new AlitripFlightServiceAirbookRequest.MemberBuyer();
obj6.setNameZh("张三");
obj6.setFamilyNameZh("张");
obj6.setGivenNameZh("三");
obj6.setFamilyNameEn("ZHANG");
obj6.setGivenNameEn("SAN");
obj6.setPhone("18457890380");
obj6.setIdCardNo("455456733456780981");
obj6.setGender(0L);
obj1.setMemberBuyer(obj6);
req.setCreateOrderRequest(obj1);
AlitripFlightServiceAirbookResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripFlightServiceAirbookRequest req = new AlitripFlightServiceAirbookRequest();
AlitripFlightServiceAirbookRequest.CreateOrderRequestDomain obj1 = new AlitripFlightServiceAirbookRequest.CreateOrderRequestDomain();
obj1.ChdBuildFee = 50L;
obj1.InfFlightItemPrice = 100L;
obj1.TotalPrice = 950L;
obj1.AdtBuildFee = 50L;
obj1.OutOrderNo = "1234324786812";
obj1.ChdTotalFee = 90L;
AlitripFlightServiceAirbookRequest.ContactDomain obj2 = new AlitripFlightServiceAirbookRequest.ContactDomain();
obj2.CredentialType = 0L;
obj2.MobilePhoneNumber = "13512344321";
obj2.CredentialNo = "110101199003076712";
obj2.MobileCountryCode = "86";
obj2.Phone = "043112345556";
obj2.Name = "张三";
obj2.Email = "111111111111@qq.com";
obj1.Contact= obj2;
obj1.AdtFlightItemPrice = 500L;
obj1.AdtOilFee = 40L;
List<AlitripFlightServiceAirbookRequest.PassengerDomain> list4 = new List<AlitripFlightServiceAirbookRequest.PassengerDomain>();
AlitripFlightServiceAirbookRequest.PassengerDomain obj5 = new AlitripFlightServiceAirbookRequest.PassengerDomain();
list4.Add(obj5);
obj5.Birthday = DateTime.Parse(2001-08-22 00:00:00");
obj5.CredentialType = 0L;
obj5.MobilePhoneNumber = "13512344321";
obj5.CredentialNo = "110101199003072770";
obj5.MobileCountryCode = "86";
obj5.Name = "李四";
obj5.Type = 0L;
obj5.GivenName = "SI";
obj5.MiddleName = "BEAN";
obj5.Surname = "LI";
obj5.Nationality = "CN";
obj5.Gender = 0L;
obj5.CredentialIssuePlace = "CN";
obj5.CredentialExpireDate = DateTime.Parse(2025-01-01 00:00:00");
obj1.PassengerList= list4;
obj1.ChdFlightItemPrice = 300L;
obj1.ChdOilFee = 40L;
obj1.ItemId = "77153a888b024ebebd8d5bf8d0db20f7_0";
obj1.AdtTotalFee = "90";
obj1.ChannelName = "feiye";
obj1.AllowRegisterOrQueryMember = true;
AlitripFlightServiceAirbookRequest.MemberBuyerDomain obj6 = new AlitripFlightServiceAirbookRequest.MemberBuyerDomain();
obj6.NameZh = "张三";
obj6.FamilyNameZh = "张";
obj6.GivenNameZh = "三";
obj6.FamilyNameEn = "ZHANG";
obj6.GivenNameEn = "SAN";
obj6.Phone = "18457890380";
obj6.IdCardNo = "455456733456780981";
obj6.Gender = 0L;
obj1.MemberBuyer= obj6;
req.CreateOrderRequest_ = obj1;
AlitripFlightServiceAirbookResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripFlightServiceAirbookRequest;
$create_order_request = new CreateOrderRequest;
$create_order_request->chd_build_fee="50";
$create_order_request->inf_flight_item_price="100";
$create_order_request->total_price="950";
$create_order_request->adt_build_fee="50";
$create_order_request->out_order_no="1234324786812";
$create_order_request->chd_total_fee="90";
$contact = new Contact;
$contact->credential_type="0";
$contact->mobile_phone_number="13512344321";
$contact->credential_no="110101199003076712";
$contact->mobile_country_code="86";
$contact->phone="043112345556";
$contact->name="张三";
$contact->email="111111111111@qq.com";
$create_order_request->contact = $contact;
$create_order_request->adt_flight_item_price="500";
$create_order_request->adt_oil_fee="40";
$passenger_list = new Passenger;
$passenger_list->birthday="2001-08-22 00:00:00";
$passenger_list->credential_type="0";
$passenger_list->mobile_phone_number="13512344321";
$passenger_list->credential_no="110101199003072770";
$passenger_list->mobile_country_code="86";
$passenger_list->name="李四";
$passenger_list->type="0";
$passenger_list->given_name="SI";
$passenger_list->middle_name="BEAN";
$passenger_list->surname="LI";
$passenger_list->nationality="CN";
$passenger_list->gender="0";
$passenger_list->credential_issue_place="CN";
$passenger_list->credential_expire_date="2025-01-01 00:00:00";
$create_order_request->passenger_list = $passenger_list;
$create_order_request->chd_flight_item_price="300";
$create_order_request->chd_oil_fee="40";
$create_order_request->item_id="77153a888b024ebebd8d5bf8d0db20f7_0";
$create_order_request->adt_total_fee="90";
$create_order_request->channel_name="feiye";
$create_order_request->allow_register_or_query_member="true";
$member_buyer = new MemberBuyer;
$member_buyer->name_zh="张三";
$member_buyer->family_name_zh="张";
$member_buyer->given_name_zh="三";
$member_buyer->family_name_en="ZHANG";
$member_buyer->given_name_en="SAN";
$member_buyer->phone="18457890380";
$member_buyer->id_card_no="455456733456780981";
$member_buyer->gender="0";
$create_order_request->member_buyer = $member_buyer;
$req->setCreateOrderRequest(json_encode($create_order_request));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alitrip.flight.service.airbook' \
-d 'partner_id=apidoc' \
-d 'session=1b1130fd-784d-4fe1-bfaf-b969d1a37dc1' \
-d 'sign=B23044756B2080FFD1830F10C938C757' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-01-30+13%3A01%3A16' \
-d 'v=2.0' \
-d 'create_order_request=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlitripFlightServiceAirbookRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.create_order_request="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alitrip.flight.service.airbook");
add_param(pRequest,"create_order_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alitrip.flight.service.airbook', {
	'create_order_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_flight_service_airbook_response>
    <order_id>4123543523452345</order_id>
    <is_success>true</is_success>
    <error_code_info>isv.SYSTEM_ERROR</error_code_info>
    <error_msg>系统错误</error_msg>
    <order_status>BOOK_SUCCEEDED</order_status>
    <out_order_no>1234324786812</out_order_no>
</alitrip_flight_service_airbook_response>

{
    "alitrip_flight_service_airbook_response":{
        "order_id":4123543523452345,
        "is_success":true,
        "error_code_info":"isv.SYSTEM_ERROR",
        "error_msg":"系统错误",
        "order_status":"BOOK_SUCCEEDED",
        "out_order_no":"1234324786812"
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

国内机票京杭API

alitrip.flight.service.airbook (生单预定)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ