接口地址:
http://api.web.ecapi.cn/vip/getRefoundOrderList
接口实例:
http://api.web.ecapi.cn/vip/getRefoundOrderList?apkey=登录会员中心查看&key=Vxxxxxxx&searchType=0&page=1
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
key | String | Vxxxxxxx | 是 | 唯品会授权账号调用key,可在会员中心“唯品会授权列表”页获取,为V开头的字符串 |
searchType | String | 0 | 是 | 查询类型:0-维权发起时间,1-维权完成时间(佣金扣除入账时间),2-佣金扣除结算时间 |
searchTimeStart | Number | xxxx | | 目标时间起始:时间戳,单位毫秒; 当searchType=0时,为维权发起时间, 当searchType=1时,为维权完成时间(佣金扣除入账时间), 当searchType=2时,为佣金扣除结算时间 |
searchTimeEnd | Number | xxxx | | 目标时间结束:时间戳,单位毫秒; 当searchType=0时,为维权发起时间, 当searchType=1时,为维权完成时间(佣金扣除入账时间), 当searchType=2时,为佣金扣除结算时间 |
orderSns | String | xxxx | | 目标订单号集合:当指定订单号集合时,目标时间区间可以不传,否则必须指定目标时间区间,多个单号以英文,分割 |
page | Number | 1 | 是 | 当前页 |
pageSize | Number | 20 | | 分页大小:默认20,最大100 |
-
返回参数
-
返回参数 | 类型 | 参数说明 | 扩展说明 |
data | Json | 返回数据列表 | |
├ total | Number | 总记录数 | |
├ page | Number | 当前页 | |
├ pageSize | Number | 分页大小 | |
├ refundOrderInfoList | Json | 联盟维权订单信息 | |
├ ├ orderSn | String | 订单号 | |
├ ├ applyTime | Number | 申请时间:时间戳,单位毫秒 | |
├ ├ refundType | Number | 维权类型:1-退货,2-换货 | |
├ ├ commissionTotalCost | String | 订单计佣金额:单位元 | |
├ ├ commission | String | 订单佣金:单位元 | |
├ ├ goodsCount | Number | 商品数量 | |
├ ├ commissionEnterTxn | String | 维权返还佣金的入账流水号 | |
├ ├ commissionEnterTime | Number | 维权返还佣金的入账时间: 时间戳,单位毫秒 | |
├ ├ commissionSettledTime | Number | 维权返回佣金的结算时间:时间戳,单位毫秒 | |
├ ├ refundOrderDetails | Json | 维权订单明细 | |
├ ├ ├ goodsId | String | 商品id | |
├ ├ ├ sizeId | String | 商品尺码id | |
├ ├ ├ goodsPrice | String | 商品价格:元 | |
├ ├ ├ goodsCount | Number | 维权商品数量 | |
├ ├ ├ commission | String | 维权商品佣金 | |
├ ├ ├ totalCost | String | 维权商品计佣金额 | |
├ ├ userId | Number | 订单归属人id | |
├ ├ orderTime | Number | 订单时间:时间戳,单位毫秒 | |
├ ├ originCommEnterTime | Number | 订单入账时间:发起维权之前入账时间,时间戳,单位毫秒 | |
├ ├ originCommEnterTxn | String | 订单入账流水:发起维权之前入账流水号 | |
├ ├ settled | Number | 售后订单结算状态:0-未结算,1-已结算 | |
├ ├ afterSaleSn | String | 售后单号 | |
├ ├ afterSaleStatus | Number | 售后单状态 | 1-售后中,2-售后完成,3-售后取消 |
-
Json返回示例
-
{"code":200,"data":{"total":0,"refundOrderInfoList":[],"pageSize":20,"page":1},"msg":"success"}
-
code/http_status说明
-
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |