接口使用场景等说明:本接口用于商品详情查询,大字段信息,包括:商品图文详情介绍(主要),以及分类等信息。
2024年12月10日后,参数入参为数字商品ID时,必须有场景ID2的权限。
API支持批量查询商品详情。
| 环境 | http 地址 | https 地址 |
|---|---|---|
| 正式环境 | http://api.veapi.cn/jd/bigfield | 暂无 |
| 参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
| skuIds | Number | 否 | 29357345299,100008656851 | skuId集合,最多支持批量入参10个sku。该接口目前只支持数字ID入参,但需要您具备场景ID2的权限,参考这里,如果没有该权限,需要购买本站的京东数字ID转英文ID的专用卡。 |
| fields | String | 否 | categoryInfo | 查询域集合,不填写则查询全部,目目前支持:categoryInfo(类目信息),imageInfo(图片信息),baseBigFieldInfo(基础大字段信息),bookBigFieldInfo(图书大字段信息),videoBigFieldInfo(影音大字段信息),detailImages(商详图) |
| itemIds | String | 否 | Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF | 联盟商品ID集合(一次最多支持查询20个itemId),为字符串数组类型,多个字符串ID时,用英文逗号相连;仅sceneId=1时支持入参。 |
| sceneId | Number | 否 | 1 | 场景ID,支持入参1,2;默认值1。场景ID 2需要在具备一定订单量后再申请权限。当您查询的是skuIds数字商品ID时,需要传入本参数sceneId=2.参考这里 |
GET/POST http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq【例子】查询数字商品ID查询,需传场景ID2
http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=100056192043&sceneId=2【例子】使用字符串ID查询多个商品
http://api.veapi.cn/jd/bigfield?vekey=xxx&itemIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq,phrnmeeihZECOGU12a2QJpU5_3erEj60sqh1NwWd4hq
$api="http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq"; $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; //返回值
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/bigfield?vekey=xxx&skuIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq";
// JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
//System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");
// 发送请求
String result = HttpRequest.get(url)
.timeout(10000)//设置超时,毫秒
.execute().body();
System.out.println(result);
}
}
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
| 参数名称 | 参数类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| skuId | Number | 是 | 100008656851 | skuId |
| skuName | String | 是 | 手机 | 商品名称 |
| categoryInfo | Map | 是 | 无 | 类目信息 |
| └─ cid1 | Number | 是 | 6144 | 一级类目ID |
| └─ cid1Name | String | 是 | 珠宝首饰 | 一级类目名称 |
| └─ cid2 | Number | 是 | 12041 | 二级类目ID |
| └─ cid2Name | String | 是 | 木手串/把件 | 二级类目名称 |
| └─ cid3 | Number | 是 | 12052 | 三级类目ID |
| └─ cid3Name | String | 是 | 其他 | 三级类目名称 |
| imageInfo | Map | 是 | 无 | 图片信息 |
| └─ url | String | 是 | http://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg | 主图链接 |
| baseBigFieldInfo | Map | 是 | 基础大字段信息 | |
| └─ wdis | String | 是 | 无 | 商品介绍 |
| └─ propCode | String | 是 | 无 | 规格参数【废弃】 |
| └─ wareQD | String | 是 | 无 | 包装清单(仅自营商品) |
| └─ propGroups | String | 否 | JSON串 | 规格参数 |
| └─ bookBigFieldInfo | Bookbigfieldinfo | 是 | 无 | 图书大字段信息 |
| └─ comments | String | 是 | 无 | 媒体评论 |
| └─ image | String | 是 | 无 | 精彩文摘与插图(插图) |
| └─ contentDesc | String | 是 | 无 | 内容摘要(内容简介) |
| └─ relatedProducts | String | 是 | 无 | 产品描述(相关商品) |
| └─ editerDesc | String | 是 | 无 | 编辑推荐 |
| └─ catalogue | String | 是 | 无 | 目录 |
| └─ bookAbstract | String | 是 | 无 | 精彩摘要(精彩书摘) |
| └─ authorDesc | String | 是 | 无 | 作者简介 |
| └─ introduction | String | 是 | 无 | 前言(前言/序言) |
| └─ productFeatures | String | 是 | 无 | 产品特色 |
| videoBigFieldInfo | Map | 是 | 无 | 影音大字段信息 |
| └─ comments | String | 是 | 无 | 评论 |
| └─ image | String | 是 | 无 | 商品描述(精彩剧照) |
| └─ contentDesc | String | 是 | 无 | 内容摘要(内容简介) |
| └─ editerDesc | String | 是 | 无 | 编辑推荐 |
| └─ catalogue | String | 是 | 无 | 目录 |
| └─ box_Contents | String | 是 | 无 | 包装清单 |
| └─ material_Description | String | 是 | 无 | 特殊说明 |
| └─ manual | String | 是 | 无 | 说明书 |
| └─ productFeatures | String | 是 | 无 | 产品特色 |
| └─ mainSkuId | Number | 否 | 6161111 | 自营主skuId |
| productId | Number | 否 | 1236547 | 非自营商品Id |
| skuStatus | Number | 否 | 1 | sku上下架状态 1:上架(可搜索,可购买), 0:下架(可通过skuid搜索,不可购买), 2:可上架(可通过skuid搜索,不可购买), 10:pop 删除(不可搜索,不可购买)) |
| owner | String | 否 | g | g=自营,p=pop |
| detailImages | String | 否 | http://img30.360buyimg.com/vc/jfs/t1/144028/20/5850/1105845/5f3cceb8Ec52ab631/da3cb259e0d83f42.jpg | 商详图 |
| itemId | String | 否 | Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF | 联盟商品ID |