【电商平台京东api接口系列】api获取商品详情Java请求返回值说明

发布时间 2023-06-23 17:08:27作者: API测试开发Cris

前言

京东商品详情API接口的作用是获取京东平台上某个商品的详细信息,包括商品标题、价格、图片、规格、参数、店铺信息等。开发者可以通过该接口获取到商品的原始数据,方便进行数据分析、价格比较、爬取等操作。

通过该接口获取到的商品详情数据可以结合其他数据进行深度挖掘,例如可以将商品数据对比分析,找出同类商品中的价格优势点和竞争对手,也可以基于商品和用户的交互数据,对用户进行画像分析和个性化推荐等。

总的来说,该接口可以帮助开发者深度挖掘京东平台上的商品数据,从而更好地为客户提供个性化服务和优质商品推荐。

jd.item_get-获得JD商品详情(注册免费获取调用测试

公共参数

名称

类型

必须

描述

key

String

调用key(必须以GET方式拼接在URL中)

secret

String

调用密钥

api_name

String

API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]

cache

String

[yes,no]默认yes,将调用缓存的数据,速度比较快

result_type

String

[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读

lang

String

[cn,en,ru]翻译语言,默认cn简体中文

version

String

API版本

请求参数

请求参数:num_iid=10335871600

参数说明:num_iid:JD商品ID

响应参数

名称

类型

是否隐私

示例值

描述

items

items[]

   

获得JD商品详情

num_iid

Bigint

 

29186819959

商品ID

title

String

 

MOCO2018夏季新品时尚V领条纹连衣裙 摩安珂 蓝白条色 S

商品标题

desc_short

String

   

商品简介

price

Float

 

719.0

价格

total_price

Float

 

0

 

suggestive_price

Float

 

0

 

orginal_price

Float

 

1199.00

原价

nick

String

 

MO&Co.官方旗舰店

掌柜昵称

num

Int

 

999

 

min_num

Int

 

0

 

detail_url

String

 

http://item.jd.com/29186819959.html

商品链接

pic_url

String

 

//img14.360buyimg.com/n0/jfs/t22033/147/1051007175/85125/c44dd0df/5b1f2855Ncbe35858.jpg

商品图片

brand

String

   

品牌名称

brandId

Int

   

品牌ID

rootCatId

Int

 

1343

顶级分类ID

cid

Int

 

9719

 

crumbs

Mix

 

[]

 

created_time

String

     

modified_time

String

     

delist_time

String

     

desc

String

     

desc_img

Mix

 

[]

 

item_imgs

Mix

 

[{ "url": "//img14.360buyimg.com/n0/jfs/t22033/147/1051007175/85125/c44dd0df/5b1f2855Ncbe35858.jpg"}]

商品图片

item_weight

String

     

item_size

String

     

location

String

   

发货地

post_fee

Float

 

6.00

物流费用

express_fee

Float

 

6.00

快递费用

ems_fee

Float

 

6.00

EMS费用

shipping_to

String

   

发货至

has_discount

Boolean

 

false

 

video

Mix

 

[]

商品视频

is_virtual

String

     

sample_id

String

   

商品风格标识ID

is_promotion

Boolean

     

props_name

String

 

0:0:尺码:S;0:1:尺码:XS;0:2:尺码:M;0:3:尺码:L;0:4:尺码:XL

商品属性名

prop_imgs

Mix

 

{"prop_img": []}

商品属性图片列表

property_alias

String

 

0:0:S;0:1:XS;0:2:M;0:3:L;0:4:XL

商品属性别名

props

Mix

 

[{ "name": "尺码","value": "S XS M L XL" }]

商品详情

total_sold

Int

     

skus

Mix

 

{"sku": [{"price": "719.00", "orginal_price": "1199.00", "properties": "0:0", "properties_name": "0:0:尺码:S", "quantity": 99, "sku_id": 29186819959, "sku_url": "http://item.jd.com/29186819959.html"}]

商品规格信息

seller_id

Int

   

卖家ID

sales

Int

   

销量

shop_id

Int

   

店铺ID

props_list

Mix

 

{"0:0": "尺码:S"}

商品属性

seller_info

Mix

 

{"level": null, "shop_type": null, "user_num_id": 57467, "cid": null, "delivery_score": null, "item_score": null, "score_p": null, "zhuy": "//moco.jd.com", "search_id": "", "nick": "MO&Co.官方旗舰店", "shop_name": "MO&Co.官方旗舰店", "title": "MO&Co.官方旗舰店" }

卖家信息

tmall

Boolean

 

false

是否天猫

error

String

   

错误信息

warning

String

   

警告信息

url_log

Mix

 

[]

 

props_img

Mix

 

[]

属性图片

shop_item

Mix

 

[]

 

relate_items

Mix

 

[]

 Java请求示例

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;

public class Example {
	private static String readAll(Reader rd) throws IOException {
		StringBuilder sb = new StringBuilder();
		int cp;
		while ((cp = rd.read()) != -1) {
			sb.append((char) cp);
		}
		return  sb.toString();
	}
	public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		conn.setDoOutput(true);
		conn.setDoInput(true);
		PrintWriter out = new PrintWriter(conn.getOutputStream());
		out.print(body);
		out.flush();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static void main(String[] args) throws IOException, JSONException {
		// 请求示例 url 默认请求参数已经URL编码处理
		String url = "https://jd/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}