三、接口定义

七鱼向三方查询数据：

请求头：

参数	字段类型	是否必须	参数说明
appId	String	否	企业的appId
nonce	String	是	随机字符串
time	String	是	当前UTC时间戳，秒为单位
checkSum	String	是	SHA1(appSecret+nonce+time)将三个参数拼接的字符串，进行SHA1哈希计算

请求体：

content-type： "application/json", 接口需要支持json形式的body请求

参数	字段类型	是否必须	参数说明
pageNo	Integer	是	当前页码（从1开始）
pageSize	Integer	是	每页展示信息数量（默认5）
tabId	String	否	商品订单列表中的标签页ID（若不传tabId，默认返回第一tab页数据。*即不传tabId时，代表用户第一个tab查询
userId	String	是	用户ID

三方返回查询数据：

参数	字段类型	是否必须	参数说明
code	Integer	是	返回码，如200
message	String	是	错误信息
data	Object	是	返回商品标签页信息

#data结构说明

参数	字段类型	是否必须	参数说明
dataList	List	否	标签页商品订单信息列表（入参未传tabId时，dataList默认返回第一个标签页数据）不支持订单&商品混合，只能单类型消息传递
tabList	List	是	标签页列表，标签页数量不可超过5个
currentTabId	String	是	当前标签页ID
pageNo	Integer	是	页码（从1开始）
pageSize	Integer	是	页大小
total	Long	是	记录数

#dataList结构说明

eventType=1时，订单字段对应显示位置如下：

参数	字段类型	是否必须	参数说明
orderId	String	是	订单ID
orderTime	String	否	时间，例：2021-01-21 01:00
orderSku	String	否	sku描述
orderCount	Integer	否	数量
orderStatus	String	否	状态描述，如：已发货、待支付
eventType	Integer	是	共两种类型：1-订单，2-商品
picture	String	是	缩略图url
title	String	是	标题
desc	String	否	描述
payMoney	String	否	价格，例如：¥19.99

eventType=2时，商品字段对应显示位置如下：

信息按照如下字段对应位置显示显示位置

参数	字段类型	是否必须	参数说明
eventType	Integer	是	共两种类型：1-订单，2-商品
picture	String	是	缩略图url
title	String	是	标题
desc	String	否	描述
price	String	否	价格，例如：¥19.99
url	String	否	商品卡片点击跳转链接

tabList结构说明

参数	字段类型	是否必须	参数说明
tabId	String	是	标签页ID
tabName	String	是	标签页名称

请求示例

返回示例

订单

   {
   "code": 200,
   "message": "查询成功",
   "data": {
       "pageNo": 1,
       "pageSize": 3,
       "operateTitle": "请选择你要咨询的内容",
       "total": 10,
       "currentTabId": "first",
       "dataList": [
           {
               "orderName": "订单号",
               "orderId": "00000000000000000001",
               "orderTime": "2021-08-23 19:23",
               "skuName": "可口可乐瓶装 330ml",
               "orderCount": 5,
               "orderStatus": "未发货",
               "eventType": 1,
               "picture": "https://gimg2.baidu.com/image_search",
               "title": "可口可乐 330ml",
               "desc": "2022春节大促",
               "price": "¥19.99"
           },
           {
               "orderName": "订单号",
               "orderId": "00000000000000000002",
               "orderTime": "2021-08-23 19:24",
               "skuName": "可口可乐瓶装 450ml",
               "orderCount": 5,
               "orderStatus": "未发货",
               "eventType": 1,
               "picture": "https://gimg2.baidu.com/image_search2",
               "title": "可口可乐 330ml",
               "desc": "2022元旦大促",
               "price": "¥29.99"
           }
       ],
       "tabList": [
           {
               "tabId": "first",
               "tabName": "未发货"
           },
           {
               "tabId": "second",
               "tabName": "已发货"
           },
           {
               "tabId": "third",
               "tabName": "售后"
           },
           {
               "tabId": "fifth",
               "tabName": "待配送"
           }
       ]
   }
}

商品

 {
   "code":200,
   "message":"查询成功",
   "data":{
       "pageNo":1,
       "pageSize":3,
       "operateTitle":"请选择你要咨询的内容",
       "total":10,
       "currentTabId":"first",
       "dataList":[
           {
               "url":"http://baidu.com",
               "eventType":2,
               "picture":"https://gimg2.baidu.coml",
               "title":"可口可乐 330ml",
               "desc":"2022春节大促",
               "price":"19.99"
           },
           {
               "url":"http://baidu.com/2",
               "eventType":2,
               "picture":"https://gimg2.baidu.coml",
               "title":"可口可乐 220ml",
               "desc":"2022元旦大促",
               "price":"19.99"
           }
       ],
       "tabList":[
           {
               "tabId":"first",
               "tabName":"未发货"
           },
           {
               "tabId":"second",
               "tabName":"已发货"
           },
           {
               "tabId":"third",
               "tabName":"售后"
           },
           {
               "tabId":"fifth",
               "tabName":"待配送"
           }
       ]
   }
}

#data结构说明#

#dataList结构说明#

#data结构说明

#dataList结构说明