API文档中心

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

学生价商品查询接口

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

根据SKUID、类目等信息查询学生价商品信息,通常用于校园推广。


注意:京东联盟官方有可能把此接口下线,当您不能调用此接口时,表示官方下线该接口。

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
skuIds String 522,112 skuid集合,长度30。如果传值,忽略其他查询条件
pageIndex Number 1 页码,默认1
pageSize Number 30 每页数量最大30,默认30
stuPriceFrom Number 100 学生专享价区间开始(单位:元)
stuPriceTo Number 1000 学生专享价区间结束(单位:元)
cid1 Number 9192 一级类目
cid2 Number 9194 二级类目
cid3 Number 9226 三级类目
owner String g g=自营,p=pop
commissionShareFrom Number 2.5 佣金比例区间开始
commissionShareTo Number 15 佣金比例区间结束
sortName String seckillPrice 排序字段,默认搜索综合排序。允许的排序字段:stuPrice、commissionShare、inOrderCount30Days、inOrderComm30Days
sort String desc desc=降序,asc=升序,可为空(默认降序)

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/stuprice?vekey=xxx&skuIds=112165 

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

$api="http://api.veapi.cn/jd/stuprice?vekey=xxx&skuIds=112165";

$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/jd/stuprice?vekey=xxx&skuIds=112165";
        // 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/jd/stuprice?vekey=xxx&skuIds=112165"

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

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

返回值(JSON)

参数名称 参数类型 是否必选 示例值 描述
skuName String 蛋卷头卷发棒 商品名称
skuId Number 4722722 商品id
imageUrl String jfs/t20533/3/360228532/173527/3108cb63/5b0bb83fNc54e6800.jpg 图片url
isStuPrice Number 1 是否学生价商品。1:是学生价商品。0:不是学生价商品。
jdPrice Number 69.9 京东价
studentPrice Number 56 学生专享价
stuPriceStartTime Number 1535644800000 专享价促销开始时间(时间戳:毫秒)
stuPriceEndTime Number 1535644800000 专享价促销结束时间(时间戳:毫秒)
cid1Id Number 737 一级类目id
cid2Id Number 1276 二级类目id
cid3Id Number 12400 三级类目id
cid1Name String 家用电器 一级类目名称
cid2Name String 个护健康 二级类目名称
cid3Name String 卷/直发器 三级类目名称
commissionShare Number 7 通用佣金比例,百分比
commission Number 3.92 通用佣金
owner String g 是否自营。g=自营,p=pop
inOrderCount30Days Number 2552 30天引入订单量(spu)
inOrderComm30Days Number 3910.81 30天支出佣金(spu)
totalCount Number 56700 总数量

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "查询成功!", "data": [ { "cid1Id": "737", "cid1Name": "家用电器", "cid2Id": "1276", "cid2Name": "个护健康", "cid3Id": "17404", "cid3Name": "电动牙刷头", "commission": "0.00", "commissionShare": "2.0", "imageUrl": "jfs/t1/214588/18/24688/76704/63b7eb7bF546d56b2/da9ea0e3c2d79cd2.jpg", "inOrderComm30Days": "88700.02", "inOrderCount30Days": "10000", "isStuPrice": "0", "jdPrice": "121.0", "owner": "g", "requestId": "s_jf_20230108_25998", "returnCode": "2", "skuId": "112165", "skuName": "欧乐B电动牙刷头 成人精准清洁型4支装 EB20-4 适配成人D/P/Pro系列小圆头牙刷", "studentPrice": "0.0" } ], "totalCount": "1", "request_id": "caJyabd" }

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部