文档中心 > API类目 > 聚石塔API

taobao.oc.tradetag.attach (订单打标或者订单标签更新)

对订单添加标签和更新标签。标签分为官方标签和自定义标签。 官方标签目前有:赠品,电子发票,收货地址变更,预售。具体格式说明请看http://open.taobao.com/doc/detail.htm?id=102731 自定义标签有2个通用属性: `show_str:给消费者显示的字符串(如果可以显示的话) `pic_urls:图片url,地址必须是图片空间的url,最多5张

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tag_name String 必须 demo 标签名称
tag_type Number 可选 2
  • 默认值:2
  • 标签类型 1:官方标签 2:自定义标签
    tag_value String 必须 {"gitfList":[{"name":"xx","num":1,"remark":"xxx"},{"name":"xx","num":1,"remark":"xxx"}]} 标签值,json格式
    tid Number 必须 123 订单id
    visible Number 可选 0
  • 默认值:0
  • 该标签在消费者端是否显示,0:不显示,1:显示

    响应参数

    名称 类型 示例值 描述
    result Boolean true 操作成功或者操作失败

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OcTradetagAttachRequest req = new OcTradetagAttachRequest();
    req.setTagName("demo");
    req.setTagType(2L);
    req.setTagValue("{\"gitfList\":[{\"name\":\"xx\",\"num\":1,\"remark\":\"xxx\"},{\"name\":\"xx\",\"num\":1,\"remark\":\"xxx\"}]}");
    req.setTid(123L);
    req.setVisible(0L);
    OcTradetagAttachResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <oc_tradetag_attach_response>
        <result>true</result>
    </oc_tradetag_attach_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部