大麦家礼品代发API

# 评论列表查询

接口地址： http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-traderates-get

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
shop_id String 是 店铺 ID
params Object 是 参数
fields String[] 是 需返回的字段列表。可选值：TradeRate 结构中的所有字段，多个字段之间用“,”分隔
rate_type String 是 评价类型。可选值：get(得到),give(给出)参数填 get 下面必须填 buyer(买家) 参数填 give 下面必须填 seller(卖家)
role String 是 评价者角色即评价的发起方。可选值：seller(卖家),buyer(买家)。 当 give buyer 以买家身份给卖家的评价； 当 get seller 以买家身份得到卖家给的评价； 当 give seller 以卖家身份给买家的评价； 当 get buyer 以卖家身份得到买家给的评价。
result String 否 评价结果。可选值：good(好评),neutral(中评),bad(差评)
page_no Number 否 页码。取值范围：大于零的整数最大限制为 200; 默认值：1
page_size Number 否 每页获取条数。默认值 40，最小值 1，最大值 150。
start_date Date 否 评价开始时。如果只输入开始时间，那么能返回开始时间之后的评价数据。
end_date Date 否 评价结束时间。如果只输入结束时间，那么全部返回所有评价数据。
tid Number 否 交易订单 id，可以是父订单 id 号，也可以是子订单 id 号
use_has_next Boolean 否 是否启用 has_next 的分页方式，如果指定 true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取评价信息，效率在原有的基础上有 80% 的提升。
num_iid Number 否 商品的数字 ID
edition string 否 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{
  "shop_id":173926031,
    "params":{
  "fields": "tid,oid,role,reply,num_iid",
  "rate_type": "get",
  "role": "seller",
  "result": "good",
  "page_no": 1,
  "page_size": 100,
  "start_date": "2011-01-01 00:00:00",
  "end_date": "2011-01-02 00:00:00",
  "tid": 123456,
  "use_has_next": true,
  "num_iid": 1234
    }
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-traderates-get' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "shop_id": "123456789",
  "fields": "tid,oid,role,reply,num_iid",
  "rate_type": "get",
  "role": "seller",
  "result": "good",
  "page_no": 1,
  "page_size": 100,
  "start_date": "2011-01-01 00:00:00",
  "end_date": "2011-01-02 00:00:00",
  "tid": 123456,
  "use_has_next": true,
  "num_iid": 1234
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-traderates-get',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "shop_id": "123456789",
  "fields": "tid,oid,role,reply,num_iid",
  "rate_type": "get",
  "role": "seller",
  "result": "good",
  "page_no": 1,
  "page_size": 100,
  "start_date": "2011-01-01 00:00:00",
  "end_date": "2011-01-02 00:00:00",
  "tid": 123456,
  "use_has_next": true,
  "num_iid": 1234
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"shop_id\": \"123456789\",\r\n  \"fields\": \"tid,oid,role,reply,num_iid\",\r\n  \"rate_type\": \"get\",\r\n  \"role\": \"seller\",\r\n  \"result\": \"good\",\r\n  \"page_no\": 1,\r\n  \"page_size\": 100,\r\n  \"start_date\": \"2011-01-01 00:00:00\",\r\n  \"end_date\": \"2011-01-02 00:00:00\",\r\n  \"tid\": 123456,\r\n  \"use_has_next\": true,\r\n  \"num_iid\": 1234\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-traderates-get")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-traderates-get"

payload = json.dumps({
  "shopId": "123456789",
  "fields": "tid,oid,role,reply,num_iid",
  "rateType": "get",
  "role": "seller",
  "result": "good",
  "page_no": 1,
  "page_size": 100,
  "start_date": "2011-01-01 00:00:00",
  "end_date": "2020-09-02 00:00:00",
  "tid": 10000000001,
  "use_has_next": True,
  "num_iid": 10000000001
})
headers = {
  'Authorization': 'd964d7b9c4365a538d9b12661f748977',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数 类型 描述
data object 返回数据
----tid Number 交易 ID
----oid Number 子订单 ID
----role String 评价者角色。可选值：seller(卖家),buyer(买家)
----nick String 评价者昵称
----result String 评价结果，可选值：good(好评),neutral(中评),bad(差评)
----created Date 评价创建时间，格式：yyyy-MM-dd HH:mm:ss
----rated_nick String 被评价者昵称
----item_title String 商品标题
----item_price Price 商品价格，精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----content String 评价内容，最大长度：500 个汉字
----reply String 评价解释，最大长度：500 个汉字
----num_iid Number 商品的数字 ID
----valid_score Boolean 评价信息是否用于记分，可取值：true(参与记分)和 false(不参与记分)
----total_results Number 搜索到的评价总数。相同的查询时间段条件下，最大只能获取总共 1500 条评价记录。所以当评价大于等于 1500 时 ISV 可以通过 start_date 及 end_date 来进行拆分，以保证可以查询到全部数据
----has_next Boolean 当使用 use_has_next 时返回信息，如果还有下一页则返回 true
----deduct_money int 消耗点券
status int 状态码，0为成功

# 返回数据

{
  "data": {
           "tid":1234,
           "oid":1234,
           "role":"seller",
           "nick":"张三",
           "result":"good(好评)",
           "created":"2010-01-01 13:30:05",
           "rated_nick":"李四",
           "item_title":"cdma冲值卡",
           "item_price":"200.07",
           "content":"很快、很好",
           "reply":"谢谢",
           "num_iid":1500006394531,
           "valid_score":true,
            "deduct_money":4
           }   ,
  "status": 0
}

# 错误码

状态码(status) 错误信息 解决方案
132 请求格式必须为JSON 修改请求参数格式为json
422 参数列表不合法，在err中会给出提示 根据提示做相应修改
200 认证失败 请确保请求头里的Authorization存在或者未过期
422 用户未登录或者非法的用户昵称 请登录或者检查自己的昵称是否合法
422 评价者角色非法;买家身份不能查询评价 使用合法的角色评价
422 评价类型非法 使用合法的评价类型
422 评价结果非法 使用合法的评价结果
422 使用了非法参数 tid 使用合法的交易父订单号
422 参数校验错误 根据提示做相应修改
422 订单不存在 使用正确的订单查询评价信息
2011 店铺未授权 使用已授权店铺
2010 未知错误 请联系客服 联系客服

← 1-9_淘宝-快递公司查询 →