文档中心 > API类目 > 度假-商品管理API

taobao.alitrip.travel.item.single.query (【API3.0】度假单个商品查询接口)

旅行度假新商品查询接口（单个商品查询）第三版

公共参数

请求地址：

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	可选	1234		商品id。itemId和outProductId至少填写一个
out_product_id	String	可选	1111		商品外部商家编码。itemId和outProductId至少填写一个

响应参数

名称	类型	示例值	描述
travel_item	PontusTravelFullTravelItem		商品查询结果
base_info PontusTravelItemBaseInfo 商品基本信息 └ accom_nights Number 2 行程晚数 └ category_id Number 123431 商品类目id └ city String 北京宝贝所在地市 └ desc String 商品描述商品描述(PC描述) └ from_locations String 北京出发地 └ item_type Number 1 商品类型：1-国内跟团游 2-国内自由行 3-出境跟团游 4-出境自由行 5-境外当地玩乐 6-国际邮轮 7-国内当地玩乐 9-国内邮轮 10-同城玩乐 └ out_id String 2312313 商户的商品编码 └ outer_title String 商家备注商家备注 └ pic_urls String [] ["xxxx","xxxxx"] 商品主图 └ prov String 北京宝贝所在地省 └ sub_titles String [] ["商品亮点1","商品亮点2"] 商品亮点 └ title String 商品标题商品标题 └ to_locations String 北京目的地 └ trip_max_days Number 2 最大出行天数 └ trip_min_days Number 1 最小出行天数 └ wap_desc String 手机端商品描述手机端商品描述 └ item_tag_content String 旅游美食商品标签 booking_rules PontusTravelBookingRuleInfo [] { "rule_type": "Fee_Excluded", "rule_desc": "描述" } 预定规则 └ rule_desc String 描述规则说明，1500个字符 └ rule_type String Fee_Excluded Fee_Included：费用包含，跟团游必填； Fee_Excluded：费用不含，所有类目必填； Order_Info：预定须知； Extra_Cost：其他费用，预留； Shopping：购物说明，预留 └ rule_list String [] 描述1,描述2 分点组织的规则说明 └ created Date 2015-09-23 20:59:41 创建时间 freedom_item_ext PontusTravelFreedomItemExt {"scenic_infos":{"scenic_desc":"描述","ticket_package_name":"门票套餐","scenic_list":[{"poi":"30.111,30.111","ticket_type":"大门票","cn_name":"故宫博物院","poi_resource":"AMAP","city":"北京"}]},"traffic_desc":"描述","go_traffic_info":{"traffic_desc":"交通描述","traffics":[{"arrival_time":"15:05","plane_type":"中型机","departure_time":"13:00","vendor":"中国国航","departure":"杭州","destination":"北京","traffic_no":"CA1710"}],"traffic_type":1},"hotel_infos":{"hotel_days":2,"hotel_desc":"demo","hotel_list":[{"poi":"30.111,30.111","house_type":"标间","hotel_level":"五星级","poi_resource":"AMAP","cn_name":"×××大酒店","city":"杭州"}]},"other_infos":[{"desc":"描述","type":"1"}],"back_traffic_info":{"traffic_desc":"交通描述","traffics":[{"arrival_time":"15:05","plane_type":"中型机","departure_time":"13:00","vendor":"中国国航","departure":"杭州","destination":"北京","traffic_no":"CA1710"}],"traffic_type":1}} 自由行相关信息 back_traffic_info PontusTravelItemTrafficInfo 回程交通信息 └ traffic_type Number 1 必填，交通类型。1/2/3/4 分别对应飞机/火车/汽车/船 traffics PontusTravelItemTraffic [] 详细交通信息结构。【注意】当traffic_type选择飞机或火车时，该字段为必填，汽车或轮船时该字段不用填。 └ arrival_time String 15:05 到达时间，当地时间HH:mm └ departure String 杭州出发城市 └ departure_time String 13:00 出发时间，当地时间HH:mm └ destination String 北京到达城市 └ plane_type String 中型机飞机机型，飞机选填 └ traffic_no String CA1710 参考班次号，飞机需要填航班号，火车需要填车次号，汽车和船可不填 └ vendor String 中国国航交通公司名，飞机选填 go_traffic_info PontusTravelItemTrafficInfo 去程交通信息 └ traffic_type Number 1 必填，交通类型。1/2/3/4 分别对应飞机/火车/汽车/船 traffics PontusTravelItemTraffic [] 详细交通信息结构。【注意】当traffic_type选择飞机或火车时，该字段为必填，汽车或轮船时该字段不用填。 └ arrival_time String 15:05 到达时间，当地时间HH:mm └ departure String 杭州出发城市 └ departure_time String 13:00 出发时间，当地时间HH:mm └ destination String 北京到达城市 └ plane_type String 中型机飞机机型，飞机选填 └ traffic_no String CA1710 参考班次号，飞机需要填航班号，火车需要填车次号，汽车和船可不填 └ vendor String 中国国航交通公司名，飞机选填 hotel_infos PontusTravelItemHotelInfo 酒店信息 hotel_list PontusTravelItemHotel [] 结构化酒店信息酒店结构化信息和文本描述二选一 └ city String 杭州必填，所在城市 └ cn_name String ×××大酒店必填，酒店名称 └ hotel_level String 五星级必填，酒店等级 └ house_type String 标间必填，酒店房型 └ poi String 30.111,30.111 酒店的经纬度信息，经度在前，纬度在后，英文逗号分隔最多支持6位小数，如120.111222,30.111222 └ poi_resource String AMAP POI来源，AMAP/GOOGLE。境内为高德（AMAP）境外为GOOGLE └ hotel_days Number 2 必填，默认为0 必须大于等于0, 且小于或等于行程晚数 └ hotel_desc String demo 酒店描述文本，<1500字符酒店结构化信息和文本描述二选一 other_infos PontusTravelItemResourceInfo [] 其他资源信息 └ desc String 描述小于1500字符 └ type Number 1 1-保险2-餐饮3-租车4-签证5-购物点6-赠品7-券99-其他 scenic_infos PontusTravelItemScenicInfo 景点信息 scenic_list PontusTravelItemScenic [] 结构化景点信息景点结构化信息和文本描述二选一 └ city String 北京必填，景点所在城市 └ cn_name String 故宫博物院必填，景点名称 └ poi String 30.111,30.111 景点的经纬度信息，经度在前，纬度在后，英文逗号分隔最多支持6位小数，如120.111222,30.111222 └ poi_resource String AMAP POI来源，AMAP/GOOGLE。境内为高德（AMAP）境外为GOOGLE └ ticket_type String 大门票必填，门票类型 └ scenic_desc String 描述景点描述文本，<1500字符景点结构化信息和文本描述二选一 └ ticket_package_name String 门票套餐门票套餐名称 └ traffic_desc String 描述自由行交通信息详细描述 group_item_ext PontusTravelGroupItemExt {"route_type":1,"go_traffic_info":{"traffic_desc":"交通描述","traffics":[{"arrival_time":"15:05","plane_type":"中型机","departure_time":"13:00","vendor":"中国国航","departure":"杭州","destination":"北京","traffic_no":"CA1710"}],"traffic_type":1},"gather_places":[{"poi":"120.111222,30.111222","name":"西湖","poi_resource":"AMAP"}],"back_traffic_info":{"traffic_desc":"交通描述","traffics":[{"arrival_time":"15:05","plane_type":"中型机","departure_time":"13:00","vendor":"中国国航","departure":"杭州","destination":"北京","traffic_no":"CA1710"}],"traffic_type":1},"electronic":true} 跟团游相关信息 back_traffic_info PontusTravelItemTrafficInfo 必填，回程交通信息 └ traffic_type Number 1 必填，交通类型。1/2/3/4 分别对应飞机/火车/汽车/船 traffics PontusTravelItemTraffic [] 详细交通信息结构。【注意】当traffic_type选择飞机或火车时，该字段为必填，汽车或轮船时该字段不用填。 └ arrival_time String 15:05 到达时间，当地时间HH:mm └ departure String 杭州出发城市 └ departure_time String 13:00 出发时间，当地时间HH:mm └ destination String 北京到达城市 └ plane_type String 中型机飞机机型，飞机选填 └ traffic_no String CA1710 参考班次号，飞机需要填航班号，火车需要填车次号，汽车和船可不填 └ vendor String 中国国航交通公司名，飞机选填 └ electronic Boolean true 是否支持电子合同，默认不支持 gather_places PontusTravelGatherPlaceInfo [] 集合地信息 └ name String 西湖地点名称 └ poi String 120.111222,30.111222 集合地经纬度，英文逗号分隔。经度在前，纬度在后，英文逗号分隔最多支持6位小数，如120.111222,30.111222 └ poi_resource String AMAP POI来源，AMAP/GOOGLE。境内为高德（AMAP）境外为GOOGLE go_traffic_info PontusTravelItemTrafficInfo 必填，去程交通信息 └ traffic_type Number 1 必填，交通类型。1/2/3/4 分别对应飞机/火车/汽车/船 traffics PontusTravelItemTraffic [] 详细交通信息结构。【注意】当traffic_type选择飞机或火车时，该字段为必填，汽车或轮船时该字段不用填。 └ arrival_time String 15:05 到达时间，当地时间HH:mm └ departure String 杭州出发城市 └ departure_time String 13:00 出发时间，当地时间HH:mm └ destination String 北京到达城市 └ plane_type String 中型机飞机机型，飞机选填 └ traffic_no String CA1710 参考班次号，飞机需要填航班号，火车需要填车次号，汽车和船可不填 └ vendor String 中国国航交通公司名，飞机选填 └ route_type Number 1 必填，线路类型，0 为目的地参团 1为出发地参团 └ item_id Number 123 商品id └ item_status Number 0 商品状态。0,1正常;-1:用户删除;-2:用户下架;-3 小二下架;-4 小二删除;-5 从未上架;-9 被处罚 └ item_type Number 1 商品类型 itineraries PontusTravelItemItineraryInfo [] { "content": "\u003ctxt\u003e文本描述1\u003c/txt\u003e\u003cimg\u003ehttps://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg\u003c/img\u003e\u003ctxt\u003e文本描述2\u003c/txt\u003e\u003cimg\u003ehttps://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg\u003c/img\u003e\u003ctxt\u003e文本描述3\u003c/txt\u003e", "title": "行程标题", "itinerary_no": 1 } 行程信息 └ content String <txt>文本描述1</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img><txt>文本描述2</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img><txt>文本描述3</txt> 必填，1.可选择纯文本 2.使用xml标签（img和txt）进行图文混排，目前仅支持一段文字和多张图片，如果文件有多段，将会被合并 3.每段行程文字总和小于1500字 └ itinerary_no Number 1 行程编号，第一天行程为1，第二天行程为2 └ title String 行程标题小于等于30字 └ modified Date 2015-09-23 20:59:41 修改时间 refund_info PontusTravelItemRefundInfo {"refund_type":0,"refund_regulations":["30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"]} 退改规则信息 └ refund_regulations String [] ["30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"] 退改规则 1）格式：标准规则或自定义规则：a_a_num 2）规则：自定义规则里最多可含5组规则 └ refund_type Number 0 退改规则类型，0为标准，1为自定义，2为不支持退改规则。不传默认为0 sale_info PontusTravelItemSaleInfo 销售属性信息 └ bc_start_date Date 2015-09-12 19:47:45 预约商品必填，普通商品不填。预约商品开始时间，格式：yyyy-MM-dd HH:mm └ duration Number 4 至少提前天数，最晚成团提前天数，最小0天，最大为300天；不传则为0 └ end_combo_date Date 2015-09-18 19:47:45 预约商品必填，普通商品可不填。可选出发结束日期，格式：年-月-日日期必须是最近300天内的，最早和最晚日期跨度最大为180天。对于普通商品，根据日历库存的最晚时间来自动计算；对于预约商品则为必填字段 └ has_discount Boolean false 是否支持会员打折。可选值：true，false；默认值：false(不打折)。不传的话默认为false └ has_invoice Boolean false 已废弃。是否提供发票默认为false 仅C商家需要设置该值 B商家强制提供发票 └ has_showcase Boolean false 是否橱窗推荐，可选值：true，false；默认值：false(不推荐) └ merchant String 0:淘宝电子凭证码商，格式为：码商id:码商nick。电子凭证的卖家规则详见：http://bangpai.taobao.com/group/thread/14051111-283426841.htm └ network_id String 1234 电子凭证网点ID └ sale_type Number 0 商品售卖类型，1. 普通商品 2. 预约商品 3. 拍卖商品 4. 非日历商品；默认为1。 └ second_kill String wap_only 商品秒杀，商品秒杀三个值：可选类型web_only(只能通过web网络秒杀)，wap_only(只能通过wap网络秒杀)，web_and_wap(既能通过web秒杀也能通过wap秒杀) └ seller_cids String [] ["12344","24332"] 关联商品与店铺类目结构:",cid1,cid2,...,"，如果店铺类目存在二级类目，必须传入子类目cids。支持的最大列表长度为：256；关于如何获取cid，请参考该接口：http://open.taobao.com/doc2/apiDetail.htm?apiId=65 └ start_combo_date Date 2015-09-12 19:47:45 预约商品必填，普通商品可不填。可选出发开始日期，格式：yyyy-MM-dd。对于普通商品，根据日历库存的最早时间来自动计算。对于预约商品则为必填字段 └ sub_stock Number 1 扣库存方式。1：拍下减库存，2：付款减库存 └ support_onsale_auto_refund Boolean false 电子凭证是否支持系统自动退款，true则表示支持 item_ele_cert_info PontusTravelItemEleCertInfo 新版电子凭证参数结构 └ expiry_date_type Number 1 电子凭证有效期过期类型。1：xxxx-xx-xx 到 xxxx-xx-xx； 2：购买成功日至 xxxx-xx-xx； 3：购买成功 xx 天内有效 └ expiry_date_start Date 2015-01-01 00:00:00 电子凭证有效期开始时间 └ expiry_date_end Date 2015-01-01 00:00:00 电子凭证有效期结束时间 └ expiry_days Number 6 电子凭证有效期天数 └ package_id Number 12234 核销门店库id └ auto_refund_rate Number 100 售中自动退款比例 └ expired_refund_rate Number 100 过期自动退款比例 └ confirm_type Number 1 资源确认方式。1：即时确认，2：二次确认 └ confirm_time Number 2 资源确认时长。1:2个工作小时内确认，2:6个工作小时内确认，3:9个工作小时内确认，4:18个工作小时内确认（只有境外目的地商品支持18小时确认，境内商品最长9小时） └ seller_id Number 12345 卖家id └ seller_nick String nick 卖家昵称 sku_infos PontusTravelItemSkuInfo [] { "package_desc": "套餐描述", "package_name": "套餐名称", "prices": [ { "price_type": "1", "operation": "add", "price": "1234", "stock": "123", "outer_price_id": "123455", "date": "2015-09-19 09:42:24" } ], "outer_sku_id": "1111" } sku信息 └ outer_sku_id String 1111 映射到具体日历价格套餐的外部商家编码 └ package_desc String 套餐描述套餐描述 └ package_name String 套餐名称套餐名称 prices PontusTravelPrices [] 套餐的日历价格库存。如果是预约商品，只需要填写一个Price，并且，不需要填写Price中的date字段不填，且预约商品只有成人价格和库存。 └ price_type Number 1 价格类型。price_type 取：1-成人价，2-儿童价，3-单房差 └ stock Number 123 库存 └ price Number 1234 价格 └ outer_price_id String 123455 外部商家团期ID └ date Date 2015-09-19 09:42:24 日期。对于普通商品必填，对于预约商品该字段不填 products PontusTravelProduct [] 套餐关联的产品元素信息 └ element_id String 12345 资源元素的外部商家编码 └ num Number 1 元素份数 └ combos String 1 套餐下面对应商品元素信息仅针对新版商品 tcwl_item_ext TcwlItemExt 11 同城活动商品相关信息 └ tcwl_theme Number 1 玩乐主题 └ tcwl_theme_play String 主题玩法主题玩法 └ organization String 组织者名称组织者名称 └ org_introduce String 组织者介绍组织者介绍 └ org_tel String 12123123 组织者电话 └ org_wangwang String 23131221 组织者旺旺 └ activity_strength Number 1 活动强度。1：底，2：中，3：高 └ activity_place String 活动地点活动地点 └ activity_time String 活动时间活动时间 gather_places GatherPlaceInfo [] 集合地信息 └ name String 地点名称地点名称 └ poi String 120.1111,30.111 经纬度 └ poi_resource String AMAP 经纬度来源 cruise_item_ext CruiseItemExt 11 航旅度假TOP API3.0 邮轮扩展信息结构 └ ship_up String 上船地点上船地点 └ ship_down String 下船地点下船地点 └ cruise_line String 邮轮线路邮轮线路 └ cruise_company String 邮轮公司邮轮公司 └ ship_name String 邮轮船名邮轮船名 └ ship_fee_include String 邮轮费用包含邮轮费用包含 └ features String 111 商品特征数据 └ ref_trip String 1111 新版行程信息 high_lights HighLights [] 产品亮点 └ title String 亮点标题亮点标题 └ desc String 亮点描述亮点描述 └ pic_urls String [] 图片列表图片列表

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelItemSingleQueryRequest req = new AlitripTravelItemSingleQueryRequest();
req.setItemId(1234L);
req.setOutProductId("1111");
AlitripTravelItemSingleQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTravelItemSingleQueryRequest req = new AlitripTravelItemSingleQueryRequest();
req.ItemId = 1234L;
req.OutProductId = "1111";
AlitripTravelItemSingleQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTravelItemSingleQueryRequest;
$req->setItemId("1234");
$req->setOutProductId("1111");
$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=taobao.alitrip.travel.item.single.query' \
-d 'partner_id=apidoc' \
-d 'session=27181fe2-7ef9-463d-8a7c-0eaa6af6a8dc' \
-d 'sign=A7EB9EA66F259C3C40234111ED357378' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-23+21%3A42%3A32' \
-d 'v=2.0' \
-d 'item_id=1234' \
-d 'out_product_id=1111'

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

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

req.item_id=1234
req.out_product_id="1111"
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,"taobao.alitrip.travel.item.single.query");
add_param(pRequest,"item_id","1234");
add_param(pRequest,"out_product_id","1111");
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('taobao.alitrip.travel.item.single.query', {
	'item_id':'1234',
	'out_product_id':'1111'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<alitrip_travel_item_single_query_response>
    <travel_item>
        <base_info>
            <accom_nights>2</accom_nights>
            <category_id>123431</category_id>
            <city>北京</city>
            <desc>商品描述</desc>
            <from_locations>北京</from_locations>
            <item_type>1</item_type>
            <out_id>2312313</out_id>
            <outer_title>商家备注</outer_title>
            <pic_urls>
                <string>[&quot;xxxx&quot;</string>
                <string>&quot;xxxxx&quot;]</string>
            </pic_urls>
            <prov>北京</prov>
            <sub_titles>
                <string>[&quot;商品亮点1&quot;</string>
                <string>&quot;商品亮点2&quot;]</string>
            </sub_titles>
            <title>商品标题</title>
            <to_locations>北京</to_locations>
            <trip_max_days>2</trip_max_days>
            <trip_min_days>1</trip_min_days>
            <wap_desc>手机端商品描述</wap_desc>
            <item_tag_content>旅游美食</item_tag_content>
        </base_info>
        <booking_rules>
            <pontus_travel_booking_rule_info>
                <rule_desc>描述</rule_desc>
                <rule_type>Fee_Excluded</rule_type>
                <rule_list>
                    <string>描述1</string>
                    <string>描述2</string>
                </rule_list>
            </pontus_travel_booking_rule_info>
        </booking_rules>
        <created>2015-09-23 20:59:41</created>
        <freedom_item_ext>
            <back_traffic_info>
                <traffic_type>1</traffic_type>
                <traffics>
                    <pontus_travel_item_traffic>
                        <arrival_time>15:05</arrival_time>
                        <departure>杭州</departure>
                        <departure_time>13:00</departure_time>
                        <destination>北京</destination>
                        <plane_type>中型机</plane_type>
                        <traffic_no>CA1710</traffic_no>
                        <vendor>中国国航</vendor>
                    </pontus_travel_item_traffic>
                </traffics>
            </back_traffic_info>
            <go_traffic_info>
                <traffic_type>1</traffic_type>
                <traffics>
                    <pontus_travel_item_traffic>
                        <arrival_time>15:05</arrival_time>
                        <departure>杭州</departure>
                        <departure_time>13:00</departure_time>
                        <destination>北京</destination>
                        <plane_type>中型机</plane_type>
                        <traffic_no>CA1710</traffic_no>
                        <vendor>中国国航</vendor>
                    </pontus_travel_item_traffic>
                </traffics>
            </go_traffic_info>
            <hotel_infos>
                <hotel_list>
                    <pontus_travel_item_hotel>
                        <city>杭州</city>
                        <cn_name>×××大酒店</cn_name>
                        <hotel_level>五星级</hotel_level>
                        <house_type>标间</house_type>
                        <poi>30.111,30.111</poi>
                        <poi_resource>AMAP</poi_resource>
                    </pontus_travel_item_hotel>
                </hotel_list>
                <hotel_days>2</hotel_days>
                <hotel_desc>demo</hotel_desc>
            </hotel_infos>
            <other_infos>
                <pontus_travel_item_resource_info>
                    <desc>描述</desc>
                    <type>1</type>
                </pontus_travel_item_resource_info>
            </other_infos>
            <scenic_infos>
                <scenic_list>
                    <pontus_travel_item_scenic>
                        <city>北京</city>
                        <cn_name>故宫博物院</cn_name>
                        <poi>30.111,30.111</poi>
                        <poi_resource>AMAP</poi_resource>
                        <ticket_type>大门票</ticket_type>
                    </pontus_travel_item_scenic>
                </scenic_list>
                <scenic_desc>描述</scenic_desc>
                <ticket_package_name>门票套餐</ticket_package_name>
            </scenic_infos>
            <traffic_desc>描述</traffic_desc>
        </freedom_item_ext>
        <group_item_ext>
            <back_traffic_info>
                <traffic_type>1</traffic_type>
                <traffics>
                    <pontus_travel_item_traffic>
                        <arrival_time>15:05</arrival_time>
                        <departure>杭州</departure>
                        <departure_time>13:00</departure_time>
                        <destination>北京</destination>
                        <plane_type>中型机</plane_type>
                        <traffic_no>CA1710</traffic_no>
                        <vendor>中国国航</vendor>
                    </pontus_travel_item_traffic>
                </traffics>
            </back_traffic_info>
            <electronic>true</electronic>
            <gather_places>
                <pontus_travel_gather_place_info>
                    <name>西湖</name>
                    <poi>120.111222,30.111222</poi>
                    <poi_resource>AMAP</poi_resource>
                </pontus_travel_gather_place_info>
            </gather_places>
            <go_traffic_info>
                <traffic_type>1</traffic_type>
                <traffics>
                    <pontus_travel_item_traffic>
                        <arrival_time>15:05</arrival_time>
                        <departure>杭州</departure>
                        <departure_time>13:00</departure_time>
                        <destination>北京</destination>
                        <plane_type>中型机</plane_type>
                        <traffic_no>CA1710</traffic_no>
                        <vendor>中国国航</vendor>
                    </pontus_travel_item_traffic>
                </traffics>
            </go_traffic_info>
            <route_type>1</route_type>
        </group_item_ext>
        <item_id>123</item_id>
        <item_status>0</item_status>
        <item_type>1</item_type>
        <itineraries>
            <pontus_travel_item_itinerary_info>
                <content>&lt;txt&gt;文本描述1&lt;/txt&gt;&lt;img&gt;https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg&lt;/img&gt;&lt;txt&gt;文本描述2&lt;/txt&gt;&lt;img&gt;https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg&lt;/img&gt;&lt;txt&gt;文本描述3&lt;/txt&gt;</content>
                <itinerary_no>1</itinerary_no>
                <title>行程标题</title>
            </pontus_travel_item_itinerary_info>
        </itineraries>
        <modified>2015-09-23 20:59:41</modified>
        <refund_info>
            <refund_regulations>
                <string>[&quot;30_30_0&quot;</string>
                <string>&quot;30_15_5&quot;</string>
                <string>&quot;14_7_15&quot;</string>
                <string>&quot;6_4_70&quot;</string>
                <string>&quot;3_1_85&quot;</string>
                <string>&quot;1_1_90&quot;]</string>
            </refund_regulations>
            <refund_type>0</refund_type>
        </refund_info>
        <sale_info>
            <bc_start_date>2015-09-12 19:47:45</bc_start_date>
            <duration>4</duration>
            <end_combo_date>2015-09-18 19:47:45</end_combo_date>
            <has_discount>false</has_discount>
            <has_invoice>false</has_invoice>
            <has_showcase>false</has_showcase>
            <merchant>0:淘宝</merchant>
            <network_id>1234</network_id>
            <sale_type>0</sale_type>
            <second_kill>wap_only</second_kill>
            <seller_cids>
                <string>[&quot;12344&quot;</string>
                <string>&quot;24332&quot;]</string>
            </seller_cids>
            <start_combo_date>2015-09-12 19:47:45</start_combo_date>
            <sub_stock>1</sub_stock>
            <support_onsale_auto_refund>false</support_onsale_auto_refund>
            <item_ele_cert_info>
                <expiry_date_type>1</expiry_date_type>
                <expiry_date_start>2015-01-01 00:00:00</expiry_date_start>
                <expiry_date_end>2015-01-01 00:00:00</expiry_date_end>
                <expiry_days>6</expiry_days>
                <package_id>12234</package_id>
                <auto_refund_rate>100</auto_refund_rate>
                <expired_refund_rate>100</expired_refund_rate>
            </item_ele_cert_info>
            <confirm_type>1</confirm_type>
            <confirm_time>2</confirm_time>
        </sale_info>
        <seller_id>12345</seller_id>
        <seller_nick>nick</seller_nick>
        <sku_infos>
            <pontus_travel_item_sku_info>
                <outer_sku_id>1111</outer_sku_id>
                <package_desc>套餐描述</package_desc>
                <package_name>套餐名称</package_name>
                <prices>
                    <pontus_travel_prices>
                        <price_type>1</price_type>
                        <stock>123</stock>
                        <price>1234</price>
                        <outer_price_id>123455</outer_price_id>
                        <date>2015-09-19 09:42:24</date>
                    </pontus_travel_prices>
                </prices>
                <products>
                    <pontus_travel_product>
                        <element_id>12345</element_id>
                        <num>1</num>
                    </pontus_travel_product>
                </products>
                <combos>1</combos>
            </pontus_travel_item_sku_info>
        </sku_infos>
        <tcwl_item_ext>
            <tcwl_theme>1</tcwl_theme>
            <tcwl_theme_play>主题玩法</tcwl_theme_play>
            <organization>组织者名称</organization>
            <org_introduce>组织者介绍</org_introduce>
            <org_tel>12123123</org_tel>
            <org_wangwang>23131221</org_wangwang>
            <activity_strength>1</activity_strength>
            <activity_place>活动地点</activity_place>
            <activity_time>活动时间</activity_time>
            <gather_places>
                <gather_place_info>
                    <name>地点名称</name>
                    <poi>120.1111,30.111</poi>
                    <poi_resource>AMAP</poi_resource>
                </gather_place_info>
            </gather_places>
        </tcwl_item_ext>
        <cruise_item_ext>
            <ship_up>上船地点</ship_up>
            <ship_down>下船地点</ship_down>
            <cruise_line>邮轮线路</cruise_line>
            <cruise_company>邮轮公司</cruise_company>
            <ship_name>邮轮船名</ship_name>
            <ship_fee_include>邮轮费用包含</ship_fee_include>
        </cruise_item_ext>
        <features>111</features>
        <ref_trip>1111</ref_trip>
        <high_lights>
            <high_lights>
                <title>亮点标题</title>
                <desc>亮点描述</desc>
                <pic_urls>
                    <string>图片列表</string>
                </pic_urls>
            </high_lights>
        </high_lights>
    </travel_item>
</alitrip_travel_item_single_query_response>

{
    "alitrip_travel_item_single_query_response":{
        "travel_item":{
            "base_info":{
                "accom_nights":2,
                "category_id":123431,
                "city":"北京",
                "desc":"商品描述",
                "from_locations":"北京",
                "item_type":1,
                "out_id":"2312313",
                "outer_title":"商家备注",
                "pic_urls":{
                    "string":[
                        "[\"xxxx\"",
                        "\"xxxxx\"]"
                    ]
                },
                "prov":"北京",
                "sub_titles":{
                    "string":[
                        "[\"商品亮点1\"",
                        "\"商品亮点2\"]"
                    ]
                },
                "title":"商品标题",
                "to_locations":"北京",
                "trip_max_days":2,
                "trip_min_days":1,
                "wap_desc":"手机端商品描述",
                "item_tag_content":"旅游美食"
            },
            "booking_rules":{
                "pontus_travel_booking_rule_info":[
                    {
                        "rule_desc":"描述",
                        "rule_type":"Fee_Excluded",
                        "rule_list":{
                            "string":[
                                "描述1",
                                "描述2"
                            ]
                        }
                    }
                ]
            },
            "created":"2015-09-23 20:59:41",
            "freedom_item_ext":{
                "back_traffic_info":{
                    "traffic_type":1,
                    "traffics":{
                        "pontus_travel_item_traffic":[
                            {
                                "arrival_time":"15:05",
                                "departure":"杭州",
                                "departure_time":"13:00",
                                "destination":"北京",
                                "plane_type":"中型机",
                                "traffic_no":"CA1710",
                                "vendor":"中国国航"
                            }
                        ]
                    }
                },
                "go_traffic_info":{
                    "traffic_type":1,
                    "traffics":{
                        "pontus_travel_item_traffic":[
                            {
                                "arrival_time":"15:05",
                                "departure":"杭州",
                                "departure_time":"13:00",
                                "destination":"北京",
                                "plane_type":"中型机",
                                "traffic_no":"CA1710",
                                "vendor":"中国国航"
                            }
                        ]
                    }
                },
                "hotel_infos":{
                    "hotel_list":{
                        "pontus_travel_item_hotel":[
                            {
                                "city":"杭州",
                                "cn_name":"×××大酒店",
                                "hotel_level":"五星级",
                                "house_type":"标间",
                                "poi":"30.111,30.111",
                                "poi_resource":"AMAP"
                            }
                        ]
                    },
                    "hotel_days":2,
                    "hotel_desc":"demo"
                },
                "other_infos":{
                    "pontus_travel_item_resource_info":[
                        {
                            "desc":"描述",
                            "type":1
                        }
                    ]
                },
                "scenic_infos":{
                    "scenic_list":{
                        "pontus_travel_item_scenic":[
                            {
                                "city":"北京",
                                "cn_name":"故宫博物院",
                                "poi":"30.111,30.111",
                                "poi_resource":"AMAP",
                                "ticket_type":"大门票"
                            }
                        ]
                    },
                    "scenic_desc":"描述",
                    "ticket_package_name":"门票套餐"
                },
                "traffic_desc":"描述"
            },
            "group_item_ext":{
                "back_traffic_info":{
                    "traffic_type":1,
                    "traffics":{
                        "pontus_travel_item_traffic":[
                            {
                                "arrival_time":"15:05",
                                "departure":"杭州",
                                "departure_time":"13:00",
                                "destination":"北京",
                                "plane_type":"中型机",
                                "traffic_no":"CA1710",
                                "vendor":"中国国航"
                            }
                        ]
                    }
                },
                "electronic":true,
                "gather_places":{
                    "pontus_travel_gather_place_info":[
                        {
                            "name":"西湖",
                            "poi":"120.111222,30.111222",
                            "poi_resource":"AMAP"
                        }
                    ]
                },
                "go_traffic_info":{
                    "traffic_type":1,
                    "traffics":{
                        "pontus_travel_item_traffic":[
                            {
                                "arrival_time":"15:05",
                                "departure":"杭州",
                                "departure_time":"13:00",
                                "destination":"北京",
                                "plane_type":"中型机",
                                "traffic_no":"CA1710",
                                "vendor":"中国国航"
                            }
                        ]
                    }
                },
                "route_type":1
            },
            "item_id":123,
            "item_status":0,
            "item_type":1,
            "itineraries":{
                "pontus_travel_item_itinerary_info":[
                    {
                        "content":"<txt>文本描述1<\/txt><img>https:\/\/img.daily.taobaocdn.net\/imgextra\/i4\/3651880377\/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg<\/img><txt>文本描述2<\/txt><img>https:\/\/img.daily.taobaocdn.net\/imgextra\/i4\/3651880377\/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg<\/img><txt>文本描述3<\/txt>",
                        "itinerary_no":1,
                        "title":"行程标题"
                    }
                ]
            },
            "modified":"2015-09-23 20:59:41",
            "refund_info":{
                "refund_regulations":{
                    "string":[
                        "[\"30_30_0\"",
                        "\"30_15_5\"",
                        "\"14_7_15\"",
                        "\"6_4_70\"",
                        "\"3_1_85\"",
                        "\"1_1_90\"]"
                    ]
                },
                "refund_type":0
            },
            "sale_info":{
                "bc_start_date":"2015-09-12 19:47:45",
                "duration":4,
                "end_combo_date":"2015-09-18 19:47:45",
                "has_discount":false,
                "has_invoice":false,
                "has_showcase":false,
                "merchant":"0:淘宝",
                "network_id":"1234",
                "sale_type":0,
                "second_kill":"wap_only",
                "seller_cids":{
                    "string":[
                        "[\"12344\"",
                        "\"24332\"]"
                    ]
                },
                "start_combo_date":"2015-09-12 19:47:45",
                "sub_stock":1,
                "support_onsale_auto_refund":false,
                "item_ele_cert_info":{
                    "expiry_date_type":1,
                    "expiry_date_start":"2015-01-01 00:00:00",
                    "expiry_date_end":"2015-01-01 00:00:00",
                    "expiry_days":6,
                    "package_id":12234,
                    "auto_refund_rate":100,
                    "expired_refund_rate":100
                },
                "confirm_type":1,
                "confirm_time":2
            },
            "seller_id":12345,
            "seller_nick":"nick",
            "sku_infos":{
                "pontus_travel_item_sku_info":[
                    {
                        "outer_sku_id":"1111",
                        "package_desc":"套餐描述",
                        "package_name":"套餐名称",
                        "prices":{
                            "pontus_travel_prices":[
                                {
                                    "price_type":1,
                                    "stock":123,
                                    "price":1234,
                                    "outer_price_id":"123455",
                                    "date":"2015-09-19 09:42:24"
                                }
                            ]
                        },
                        "products":{
                            "pontus_travel_product":[
                                {
                                    "element_id":"12345",
                                    "num":1
                                }
                            ]
                        },
                        "combos":"1"
                    }
                ]
            },
            "tcwl_item_ext":{
                "tcwl_theme":1,
                "tcwl_theme_play":"主题玩法",
                "organization":"组织者名称",
                "org_introduce":"组织者介绍",
                "org_tel":"12123123",
                "org_wangwang":"23131221",
                "activity_strength":1,
                "activity_place":"活动地点",
                "activity_time":"活动时间",
                "gather_places":{
                    "gather_place_info":[
                        {
                            "name":"地点名称",
                            "poi":"120.1111,30.111",
                            "poi_resource":"AMAP"
                        }
                    ]
                }
            },
            "cruise_item_ext":{
                "ship_up":"上船地点",
                "ship_down":"下船地点",
                "cruise_line":"邮轮线路",
                "cruise_company":"邮轮公司",
                "ship_name":"邮轮船名",
                "ship_fee_include":"邮轮费用包含"
            },
            "features":"111",
            "ref_trip":"1111",
            "high_lights":{
                "high_lights":[
                    {
                        "title":"亮点标题",
                        "desc":"亮点描述",
                        "pic_urls":{
                            "string":[
                                "图片列表"
                            ]
                        }
                    }
                ]
            }
        }
    }
}

异常示例

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"
	}
}

错误码解释

错误码	错误描述	解决方案
isp.remote-service-error	系统错误	联系服务提供方
isv.invalid-parameter:NOTNULL	参数不能为空	调用方排查
isv.biz-error:ITEM_NOT_FOUNT	找不到该商品，商品可能已被删除	调用方排查
isv.rights-invalid:VIEW_NOT_PERMIT	该商品不属于您，您没有权限查询此宝贝	该商品不属于您，您没有权限查询此宝贝
isv.invalid-parameter:ERROR	参数错误	请根据错误提示修改

API工具

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

如何获得此API

FAQ

查询单个商品用商家外部编码查不到

我要提问

返回
顶部

开放平台

度假-商品管理API

taobao.alitrip.travel.item.single.query (【API3.0】度假单个商品查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ