接口地址:
http://api.web.ecapi.cn/vip/getOrderList
接口实例:
http://api.web.ecapi.cn/vip/getOrderList?apkey=登录会员中心查看&key=Vxxxxxxx&page=1
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
key |
String |
Vxxxxxxx |
是 |
唯品会授权账号调用key,可在会员中心“唯品会授权列表”页获取,为V开头的字符串 |
page |
Number |
1 |
是 |
页码 |
status |
Number |
订单状态 |
|
0-不合格,1-待定,2-已完结,该参数不设置默认代表全部状态 |
orderTimeStart |
Number |
订单时间起始 时间戳 |
|
单位毫秒 |
orderTimeEnd |
Number |
订单时间结束 时间戳 |
|
单位毫秒 |
pageSize |
Number |
页面大小:默认20 |
|
|
updateTimeStart |
Number |
更新时间-起始 时间戳 |
|
单位毫秒 |
updateTimeEnd |
Number |
更新时间-结束 时间戳 |
|
单位毫秒 |
orderSnList |
String |
xxxx |
|
订单号列表:当传入订单号列表时,订单时间和更新时间区间可不传入,多个订单以英文,分割 |
-
返回参数
-
返回参数 |
类型 |
参数说明 |
扩展说明 |
data |
Json |
返回数据列表 |
|
├ total |
String |
总条数 |
|
├ page |
Number |
当前页码 |
|
├ pageSize |
Number |
页面大小 |
|
├ orderInfoList |
Json |
查询响应结果 |
|
├ ├ orderSn |
String |
订单号 |
|
├ ├ status |
Number |
订单状态 |
0-不合格,1-待定,2-已完结 |
├ ├ newCustomer |
Number |
新老客 |
0-待定,1-新客,2-老客 |
├ ├ channelTag |
String |
渠道标识 |
|
├ ├ orderTime |
Number |
下单时间 时间戳 单位毫秒 |
|
├ ├ signTime |
Number |
签收时间 时间戳 单位毫秒 |
|
├ ├ settledTime |
Number |
结算时间 时间戳 单位毫秒 |
|
├ ├ detailList |
Json |
商品明细 |
|
├ ├ ├ goodsId |
String |
商品id |
|
├ ├ ├ goodsName |
String |
商品名称 |
|
├ ├ ├ goodsThumb |
String |
商品缩略图 |
|
├ ├ ├ goodsCount |
Number |
商品数量 |
|
├ ├ ├ commissionTotalCost |
String |
商品计佣金额 |
|
├ ├ ├ commissionRate |
String |
商品佣金比例 |
|
├ ├ ├ commission |
String |
商品佣金金额 |
|
├ ├ ├ commCode |
String |
佣金编码:对应商品二级分类 |
|
├ ├ ├ commName |
String |
佣金方案名称 |
|
├ ├ ├ orderSource |
String |
订单来源 |
|
├ ├ ├ afterSaleInfo |
Json |
商品售后信息 |
|
├ ├ ├ ├ afterSaleChangedCommission |
String |
商品佣金售后变动:仅在订单完结之后发生售后时返回,无售后时为空 |
|
├ ├ ├ ├ afterSaleChangedGoodsCount |
String |
商品数量售后变动:仅在订单完结之后发生售后时返回,无售后时为空 |
|
├ ├ ├ ├ afterSaleSn |
String |
商品售后单号,无售后时为空 |
|
├ ├ ├ ├ afterSaleStatus |
Number |
商品售后状态:1-售后中,2-售后完成,3-售后取消,无售后时为空 |
|
├ ├ ├ ├ afterSaleType |
Number |
售后类型:1-退货,2-换货,无售后时为空 |
|
├ ├ ├ ├ afterSaleFinishTime |
Number |
售后完成时间,时间戳,单位:毫秒,无售后时为空 |
|
├ ├ ├ sizeId |
String |
商品尺码:2019.01.01之后可用 |
|
├ ├ ├ status |
String |
商品状态:0-不合格,1-待定,2-已完结 |
|
├ ├ lastUpdateTime |
Number |
订单上次更新时间 时间戳 单位毫秒 |
|
├ ├ settled |
Number |
订单结算状态 |
0-未结算,1-已结算 |
├ ├ selfBuy |
Number |
是否自推自买 |
0-否,1-是 |
├ ├ orderSubStatusName |
String |
订单子状态 |
流转状态-支持状态:(已下单、已付款、已签收、待结算、已结算、已失效) |
├ ├ commission |
String |
商品总佣金:单位元 |
|
├ ├ afterSaleChangeCommission |
String |
售后订单佣金变动:仅在订单完结之后发生售后行为时返回 |
|
├ ├ afterSaleChangeGoodsCount |
Number |
售后订单总商品数量变动:仅在订单完结之后发生售后行为时返回 |
|
├ ├ commissionEnterTime |
Number |
入账时间,时间戳,单位毫秒 |
|
├ ├ orderSource |
String |
订单来源 |
|
├ ├ pid |
String |
推广PID:目前等同于channelTag |
|
├ ├ isPrepay |
String |
是否预付订单 |
0-否,1-是 |
├ ├ totalCost |
String |
订单支付金额:单位元 |
|
-
Json返回示例
-
{"code":200,"data":{"total":0,"pageSize":20,"page":1,"orderInfoList":[]},"msg":"success"}
-
code/http_status说明
-
code/http_status |
说明 |
200 |
数据获取成功 |
-1 |
数据获取失败 |
401 |
IP没有添加白名单 |
429 |
访问次数超限 |
403 |
关键参数丢失 |
405 |
请求方式不对 |