文档中心 > 订单打标服务

taobao.oc.tradetags.get (根据订单查询订单标签)

根据订单查询订单标签。
返回的tag说明:1为官方标,2为自定义标,3为主站只读标签。
官方标签和自定义标签请看taobao.oc.tradetag.attach 接口说明
主站只读标签请看:http://open.taobao.com/doc/detail.htm?id=102865

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
history Number 可选 0 是否查询历史标签
tid Number 必须 192486257880538 交易主订单id
tag_types String [] 可选 1,2,3
  • 最大列表长度:20
  • 不填,则默认只查询1,2。1为官方标,2为自定义标,3为主站只读标签
    tag_names String [] 可选 赠品
  • 最大列表长度:20
  • 不填,则不做标签名称过滤

    响应参数

    名称 类型 示例值 描述
    trade_tags TradeTagRelationDo [] 返回结果
    • └ id
    • Number
    • 25032
    • 订单标签记录id
    • └ tid
    • Number
    • 192486257880538
    • 订单id
    • └ tag_name
    • String
    • 预售
    • 标签名称
    • └ tag_type
    • Number
    • 1
    • 标签类型 1:官方标签 2:自定义标签 3:主站只读标签
    • └ tag_value
    • String
    • {“key”:"value"}
    • 标签值,json格式
    • └ gmt_created
    • Date
    • 2015-01-16 18:01:04
    • 记录的创建时间
    • └ gmt_modified
    • Date
    • 2015-01-16 18:01:03
    • 记录的最新修改时间
    • └ visible
    • Number
    • 0
    • 该标签在消费者端是否显示,0:不显示,1:显示
    • history_trade_tag_relations
    • HistoryTradeRelationDo []
    • 该标签操作的历史记录
    • └ id
    • Number
    • 25032
    • 订单标签记录id
    • └ tid
    • Number
    • 192486257880538
    • 订单id
    • └ tag_name
    • String
    • 预售
    • 标签名称
    • └ tag_type
    • Number
    • 1
    • 标签类型 1:官方标签 2:自定义标签
    • └ tag_value
    • String
    • {“key”:"value"}
    • 标签值,json格式
    • └ gmt_created
    • Date
    • 2015-01-30 10:08:14
    • 记录的创建时间
    • └ gmt_modified
    • Date
    • 2015-01-30 10:08:14
    • 记录的最新修改时间
    • └ visible
    • Number
    • 0
    • 该标签在消费者端是否显示,0:不显示,1:显示

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OcTradetagsGetRequest req = new OcTradetagsGetRequest();
    req.setHistory(0L);
    req.setTid(192486257880538L);
    req.setTagTypes("1,2,3");
    req.setTagNames("赠品");
    OcTradetagsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <oc_tradetags_get_response>
        <trade_tags>
            <trade_tag_relation_do>
                <id>25032</id>
                <tid>192486257880538</tid>
                <tag_name>预售</tag_name>
                <tag_type>1</tag_type>
                <tag_value>{“key”:&quot;value&quot;}</tag_value>
                <gmt_created>2015-01-16 18:01:04</gmt_created>
                <gmt_modified>2015-01-16 18:01:03</gmt_modified>
                <visible>0</visible>
                <history_trade_tag_relations>
                    <history_trade_relation_do>
                        <id>25032</id>
                        <tid>192486257880538</tid>
                        <tag_name>预售</tag_name>
                        <tag_type>1</tag_type>
                        <tag_value>{“key”:&quot;value&quot;}</tag_value>
                        <gmt_created>2015-01-30 10:08:14</gmt_created>
                        <gmt_modified>2015-01-30 10:08:14</gmt_modified>
                        <visible>0</visible>
                    </history_trade_relation_do>
                </history_trade_tag_relations>
            </trade_tag_relation_do>
        </trade_tags>
    </oc_tradetags_get_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

    返回
    顶部