API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

唯品会联盟维权订单列表查询接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

获取唯享客的维权订单列表,注意最大查询时间区间默认不超过60天。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/vip/vip_refundorder 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
searchType Integer 1 查询类型:0-维权发起时间,1-维权完成时间(佣金扣除入账时间),2-佣金扣除结算时间
searchTimeStart Long 1 目标时间起始:时间戳,单位毫秒; 这个参数取决于searchType类型决定它是发起时间,还是结算时间,还是完成时间。当searchType=0时,为维权发起时间,当searchType=1时,为维权完成时间(佣金扣除入账时间),当searchType=2时,为佣金扣除结算时间。
searchTimeEnd Long   目标时间结束,最大查询时间区间默认不超过60天:时间戳,单位毫秒; 当searchType=0时,为维权发起时间,当searchType=1时,为维权完成时间(佣金扣除入账时间), 当searchType=2时,为佣金扣除结算时间
orderSns List   目标订单号集合:当指定订单号集合时,目标时间区间可以不传,否则必须指定目标时间区间
page Integer 1 当前页
pageSize Integer 20 分页大小:默认20,最大100

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/vip/vip_refundorder?vekey=xxx&orderSns=23011151827442 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/vip/vip_refundorder?vekey=xxx&orderSns=23011151827442";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流,不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/vip/vip_refundorder?vekey=xxx&orderSns=23011151827442";
        // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时,毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/vip/vip_refundorder?vekey=xxx&orderSns=23011151827442"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值(JSON)

参数名称 参数类型 是否必选 示例值 描述
orderSn String 23011151827442 订单号
applyTime Long   申请时间:时间戳,单位毫秒
refundType Integer   维权类型:1-退货,2-换货,3-价保,4-仅退款
commissionTotalCost String   订单计佣金额(元,两位小数)
commission String   订单佣金(元,两位小数)
goodsCount Integer   商品数量
commissionEnterTxn String   维权返还佣金的入账流水号
commissionEnterTime Long   维权返还佣金的入账时间: 时间戳,单位毫秒
commissionSettledTime Long   维权返回佣金的结算时间:时间戳,单位毫秒
refundOrderDetails List   维权订单明细
 └─ goodsId String   商品id
 └─ sizeId String   商品尺码id
 └─ goodsPrice String   商品价格:元
 └─ goodsCount Integer   维权商品数量
 └─ commission String   维权商品佣金
 └─ totalCost String   维权商品计佣金额
userId Long   订单归属人id
orderTime Long   订单时间:时间戳,单位毫秒
originCommEnterTime Long   订单入账时间:发起维权之前入账时间,时间戳,单位毫秒
originCommEnterTxn String   订单入账流水:发起维权之前入账流水号
settled Integer   售后订单结算状态:0-未结算,1-已结算
afterSaleSn String   售后单号
afterSaleStatus Short   售后单状态:1-售后中,2-售后完成,3-售后取消

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "接口调用成功!", "data": { "total": 0, "refundOrderInfoList": [ { "goodsId": "2334673541800410", "sizeId": "2334673541808602", "goodsPrice": "9.31", "goodsCount": 1, "commission": "2.1", "totalCost": "0" } ], "pageSize": 20, "page": 1 }, "request_id": "fLmzaR5" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部