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

taobao.alitrip.travel.item.element.manage (【API3.0】资源元素管理接口)

资源元素管理接口:提供商家管理(增删改)基本资源元素信息。基本资源元素可供多个商品共享

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
operation Number 必须 1 必填,操作类型:1-新增,2-修改,3-删除。。特别注意:删除 为逻辑删除,即该outer_id所对应的元素还存在但是会置为无效状态,重新编辑修改即可恢复为有效状态。因此该id一旦使用将不可重复
outer_id String 必须 0001 必填,元素的外部商家编码,必须唯一。编辑、删除时将根据该编码找到对应元素。
element_type Number 可选 2 资源元素类型,新增时必填:1-景点,2-酒店,5-交通接驳,6-WIFI库;8-餐饮,9-签证库,11-特色活动,999-其他
name String 可选 香格里拉大酒店 元素名称,新增时必填; 注意:Wifi库的使用地和签证库所在国家均适用这个字段
city String 可选 杭州 元素所在城市,景点、酒店在新增时必填
type String 可选 标准间 元素的子类型,新增时必填。景点指门票类型,酒店指房型信息,交通接驳(接送机、接驳车、租车、船票、其他)选其一,餐饮(早餐、晚餐、午餐、下午茶及其他)选其一;签证(旅游签证、商务签证、工作签证、留学签证、探亲访友签证、入台证、其他)
desc String 可选 其他资源 描述 当新增“交通接驳、餐饮、特色活动、其他”资源类型时 必填

响应参数

名称 类型 示例值 描述
first_result TopElementResult firstResult
  • └ element_outer_id
  • String
  • 0001
  • 元素的外部商家编码
  • └ created
  • Date
  • 2016-9-07 22:56:18
  • 创建时间
  • └ modified
  • Date
  • 2016-9-07 22:56:18
  • 修改时间
  • └ deleted
  • Date
  • 2016-9-07 22:56:18
  • 删除时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelItemElementManageRequest req = new AlitripTravelItemElementManageRequest();
req.setOperation(1L);
req.setOuterId("0001");
req.setElementType(2L);
req.setName("香格里拉大酒店");
req.setCity("杭州");
req.setType("标准间");
req.setDesc("其他资源 描述");
AlitripTravelItemElementManageResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_travel_item_element_manage_response>
    <first_result>
        <element_outer_id>0001</element_outer_id>
        <created>2016-9-07 22:56:18</created>
        <modified>2016-9-07 22:56:18</modified>
        <deleted>2016-9-07 22:56:18</deleted>
    </first_result>
</alitrip_travel_item_element_manage_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.WRONG_PARAMS 字段不符合规范 请根据错误提示修改
isv.PARAM_EXCEPTION::ELEMENT_IS_EXIST 资源元素不存在 请根据错误提示修改
isv.PARAM_EXCEPTION 参数异常 请根据错误提示修改
isv.PARAM_EXCEPTION::ELEMENT_NOT_EXIST 资源元素已经存在 请根据错误提示修改

API工具

如何获得此API

FAQ

返回
顶部