tmall.exchange.messages.get (查询换货订单留言列表)

查询换货订单留言列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
operator_roles String [] 可选 1,2
  • 最大列表长度:20
  • 留言创建角色。具体包括:卖家主账户(1)、卖家子账户(2)、小二(3)、买家(4)、系统(5)、系统超时(6)
    page_size Number 可选 10
  • 默认值:10
  • 每页条数
    dispute_id Number 必须 123123123 换货单号ID
    page_no Number 可选 1
  • 默认值:1
  • 页码
    fields String [] 必须 id,refund_id,owner_id,owner_nick,owner_role,content,pic_urls,created,message_type
  • 最大列表长度:20
  • 返回的字段。具体包括:id,refund_id,owner_id,owner_nick,owner_role,content,pic_urls,created,message_type

    响应参数

    名称 类型 示例值 描述
    result RefundMessageResult 返回结果
    • └ page_results
    • Number
    • 10
    • 当前页面的留言条数
    • results
    • RefundMessage []
    • 留言记录
    • └ id
    • Number
    • 789789789
    • 留言ID
    • └ refund_id
    • Number
    • 123123
    • 换货单号ID
    • └ owner_id
    • Number
    • tb22233444
    • 留言者ID
    • └ owner_nick
    • String
    • 梅西
    • 留言者昵称
    • └ content
    • String
    • 我要换货!
    • 留言内容
    • pic_urls
    • PicUrl []
    • 凭证信息
    • └ url
    • String
    • file:///Users/laoxin/Desktop/thread_29658922_20170730123642_s_405856_h_106px_w_152px1771332127.gif
    • 凭证图片url
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 留言创建时期
    • └ message_type
    • String
    • 111
    • 留言类型
    • └ owner_role
    • String
    • 111
    • 留言角色
    • └ open_uid
    • String
    • ADSDSDSDSDSDSD
    • 留言者openId
    • └ total_results
    • Number
    • 111
    • 所有留言记录数
    • └ has_next
    • Boolean
    • true
    • 是否有下一页
    • └ error_code
    • String
    • 111
    • 错误码
    • └ error_msg
    • String
    • 111
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallExchangeMessagesGetRequest req = new TmallExchangeMessagesGetRequest();
    req.setOperatorRoles("1,2");
    req.setPageSize(10L);
    req.setDisputeId(123123123L);
    req.setPageNo(1L);
    req.setFields("id,refund_id,owner_id,owner_nick,owner_role,content,pic_urls,created,message_type");
    TmallExchangeMessagesGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_exchange_messages_get_response>
        <result>
            <page_results>10</page_results>
            <results>
                <refund_message>
                    <id>789789789</id>
                    <refund_id>123123</refund_id>
                    <owner_id>tb22233444</owner_id>
                    <owner_nick>梅西</owner_nick>
                    <content>我要换货!</content>
                    <pic_urls>
                        <pic_url>
                            <url>file:///Users/laoxin/Desktop/thread_29658922_20170730123642_s_405856_h_106px_w_152px1771332127.gif</url>
                        </pic_url>
                    </pic_urls>
                    <created>2000-01-01 00:00:00</created>
                    <message_type>111</message_type>
                    <owner_role>111</owner_role>
                    <open_uid>ADSDSDSDSDSDSD</open_uid>
                </refund_message>
            </results>
            <total_results>111</total_results>
            <has_next>true</has_next>
            <error_code>111</error_code>
            <error_msg>111</error_msg>
        </result>
    </tmall_exchange_messages_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

    返回
    顶部