淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
企业微信
点击获取APKEY

正常 (重构版)查询订单列表

更新时间:2020-09-03 12:39:51

请求链接: http://api.web.21ds.cn/vip/getOrderList
请求实例: http://api.web.21ds.cn/vip/getOrderList?apkey=登录后即可显示&key=Vxxxxxxx&page=1 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 查询订单列表,最大查询时间区间默认不超过10天
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-
限时推广:送你100元借款优惠券!借款时可用。(数量有限,先到先得) ->>立即领取<<-

使用说明

最大查询时间区间默认不超过10天

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
keyStringVxxxxxxx唯品会授权账号调用key,可在会员中心“唯品会授权列表”页获取,为V开头的字符串
pageNumber1页码
statusNumber订单状态0-不合格,1-待定,2-已完结,该参数不设置默认代表全部状态
orderTimeStartNumber订单时间起始 时间戳单位毫秒
orderTimeEndNumber订单时间结束 时间戳单位毫秒
pageSizeNumber页面大小:默认20
updateTimeStartNumber更新时间-起始 时间戳单位毫秒
updateTimeEndNumber更新时间-结束 时间戳单位毫秒
orderSnListStringxxxx订单号列表:当传入订单号列表时,订单时间和更新时间区间可不传入,多个订单以英文,分割

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ totalString总条数
 ├ pageNumber当前页码
 ├ pageSizeNumber页面大小
 ├ orderInfoListJson查询响应结果
 ├  ├ orderSnString订单号
 ├  ├ statusNumber订单状态0-不合格,1-待定,2-已完结
 ├  ├ newCustomerNumber新老客0-待定,1-新客,2-老客
 ├  ├ channelTagString渠道标识
 ├  ├ orderTimeNumber下单时间 时间戳 单位毫秒
 ├  ├ signTimeNumber签收时间 时间戳 单位毫秒
 ├  ├ settledTimeNumber结算时间 时间戳 单位毫秒
 ├  ├ detailListJson商品明细
 ├  ├  ├ goodsIdString商品id
 ├  ├  ├ goodsNameString商品名称
 ├  ├  ├ goodsThumbString商品缩略图
 ├  ├  ├ goodsCountNumber商品数量
 ├  ├  ├ commissionTotalCostString商品计佣金额
 ├  ├  ├ commissionRateString商品佣金比例
 ├  ├  ├ commissionString商品佣金金额
 ├  ├  ├ commCodeString佣金编码:对应商品二级分类
 ├  ├  ├ commNameString佣金方案名称
 ├  ├  ├ orderSourceString订单来源
 ├  ├  ├ afterSaleInfoJson商品售后信息
 ├  ├  ├  ├ afterSaleChangedCommissionString商品佣金售后变动:仅在订单完结之后发生售后时返回,无售后时为空
 ├  ├  ├  ├ afterSaleChangedGoodsCountString商品数量售后变动:仅在订单完结之后发生售后时返回,无售后时为空
 ├  ├  ├  ├ afterSaleSnString商品售后单号,无售后时为空
 ├  ├  ├  ├ afterSaleStatusNumber商品售后状态:1-售后中,2-售后完成,3-售后取消,无售后时为空
 ├  ├  ├  ├ afterSaleTypeNumber售后类型:1-退货,2-换货,无售后时为空
 ├  ├  ├  ├ afterSaleFinishTimeNumber售后完成时间,时间戳,单位:毫秒,无售后时为空
 ├  ├  ├ sizeIdString商品尺码:2019.01.01之后可用
 ├  ├  ├ statusString商品状态:0-不合格,1-待定,2-已完结
 ├  ├ lastUpdateTimeNumber订单上次更新时间 时间戳 单位毫秒
 ├  ├ settledNumber订单结算状态0-未结算,1-已结算
 ├  ├ selfBuyNumber是否自推自买0-否,1-是
 ├  ├ orderSubStatusNameString订单子状态流转状态-支持状态:(已下单、已付款、已签收、待结算、已结算、已失效)
 ├  ├ commissionString商品总佣金:单位元
 ├  ├ afterSaleChangeCommissionString售后订单佣金变动:仅在订单完结之后发生售后行为时返回
 ├  ├ afterSaleChangeGoodsCountNumber售后订单总商品数量变动:仅在订单完结之后发生售后行为时返回
 ├  ├ commissionEnterTimeNumber入账时间,时间戳,单位毫秒
 ├  ├ orderSourceString订单来源
 ├  ├ pidString推广PID:目前等同于channelTag
 ├  ├ isPrepayString是否预付订单0-否,1-是

Json返回示例

{"code":200,"data":{"total":0,"pageSize":20,"page":1,"orderInfoList":[]},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对