文档中心 > API类目 > 门票-商品管理API

alitrip.ticket.scenic.bind (【门票API2.0】门票景点绑定接口)

门票景点绑定接口,用于建立阿里标准景点id与商家系统景点id的映射关系。该接口同时支持新建和修改映射关系,当用户没有为ali_scenic_id建立过映射关系时,则判断为新建映射关系,否则为修改。可以通过设置update_out_scenic_id来修改ali_scenic_id与out_scenic_id的映射关系。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ali_scenic_id Number 必须 24498 必填,阿里旅行对应的景点编码
city String 可选 杭州 商户景点城市
address String 可选 西湖区 商户景点地址
out_scenic_name String 可选 西湖 商户景点名称
province String 可选 浙江 商户景点省份
out_scenic_id String 必须 1111 必填,商户系统中的景点编码,用于与ali_scenic_id建立映射关系
update_out_scenic_id String 可选 2222 可选,如果需要更新out_scenic_id与ali_scenic_id的映射关系时 需要填写

响应参数

名称 类型 示例值 描述
first_result TicketScenicResult 景点绑定结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ out_scenic_id
  • String
  • 1111
  • 商家景点编码
  • └ ali_scenic_id
  • Number
  • 24498
  • 阿里标准景点库ID
  • └ extend
  • String
  • 预留
  • 扩展字段,预留

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTicketScenicBindRequest req = new AlitripTicketScenicBindRequest();
req.setAliScenicId(24498L);
req.setCity("杭州");
req.setAddress("西湖区");
req.setOutScenicName("西湖");
req.setProvince("浙江");
req.setOutScenicId("1111");
req.setUpdateOutScenicId("2222");
AlitripTicketScenicBindResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ticket_scenic_bind_response>
    <first_result>
        <success>true</success>
        <out_scenic_id>1111</out_scenic_id>
        <ali_scenic_id>24498</ali_scenic_id>
        <extend>预留</extend>
    </first_result>
</alitrip_ticket_scenic_bind_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案
isv.PARAM_EXCEPTION 参数异常 请根据错误提示修改
isv.OUT_SYS_EXCEPTION::待更新的卖家景点不存在 参数异常 根据错误提示修改
isv.OUT_SYS_EXCEPTION::待新增的景点对应的标准景点ID下已经存在该卖家的景点 参数异常 根据错误提示修改

API工具

如何获得此API

FAQ

返回
顶部