java/PHP 调用JD平台商品详情API接口

电商大数据APIGirl
190 阅读3分钟

如果您的应用已和京东JOS对接，需要获取一些与用户紧密相关的信息（如订单、商品、促销等），为保证数据的安全性和隐私性，需要取得用户的同意，引导用户授权。JOS采用国际通用的OAuth2.0标准协议，支持网站、桌面客户端、ERP系统。

jd API 接入说明

  1. API地址:

  2. 调用示例：

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://api.onebound.cn/taobao/demo/sdk2020/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/jd/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

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://api-gw.onebound.cn/jd/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}

  1. 参数说明

    • 通用参数说明

      • url说明 平台：淘宝，京东等， API类型:[item_search,item_get,item_search_shop等]
      • version:API版本
      • key:调用key,测试（点&击&注&册&免&调&用）
      • secret:调用secret,测试secret:(不用填写)
      • cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
      • result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
      • lang:[cn,en,ru] 翻译语言，默认cn简体中文
      • secret:密钥

    • API:item_search 参数说明：

      • q:搜索关键字
      • cat:分类ID
      • start_price:开始价格
      • end_price:结束价格
      • sort:排序[bid,bid,bid2,_bid2,_sale,_credit]
        (bid:总价,bid2:商品价格,sale:销量,credit信用,加        前缀为从大到小排序)
      • page:页数
      • page_size:每页宝贝数量，默认40
      • seller_info:是否获取商家信息[yes,no],默认yes

    • API:item_get 参数说明: num_iid:宝贝ID

响应示例

{
	"item": {
		"num_iid": "10335871600",
		"title": "安踏男鞋休闲运动鞋男士2021春季网面透气轻便板鞋慢跑步鞋子户外训练旅游 -6安踏白 42",
		"desc_short": "",
		"price": "159.00",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "249.00",
		"nick": "安踏悠购专卖店",
		"num": 999,
		"min_num": 0,
		"detail_url": "https://item.jd.com/10335871600.html",
		"pic_url": "//img10.360buyimg.com/n1/jfs/t1/161425/26/11624/223402/6048750bE7b82f057/24b57f419c846302.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": 12099,
		"cid": 9756,
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<p><br></p><p><img src="https://img10.360buyimg.com/imgzone/jfs/t1/38380/20/8577/216030/5cfdcf2eE3d3c15fc/9072ee4986b3f8d4.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t11302/317/3187030400/282664/5886b268/5ce3c383N6572b1da.jpg"><br></p><p><img src="http://img30.360buyimg.com/popWaterMark/jfs/t29380/248/1583857170/211757/8803264c/5ce3c383Nf658d385.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/109234/40/8433/163092/5e6764a2E4e1a8595/47322c3588d6d0c8.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/89006/11/14706/167699/5e6764a2E68bdab3a/be235af214561ca7.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/109389/11/8312/121412/5e6764a2E0699edcb/74e48d00298808af.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/93399/24/14627/132014/5e6764a3E0f078e8e/8598eb9176d64a6c.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/107443/10/8345/114390/5e6764a3Ea1726cee/45cfa1a0f7a8df0c.jpg"></p><p><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/96343/40/10991/241473/5e257548Ed6f96ea3/b52ab120eb9f7db0.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/101185/7/11047/209310/5e257548E8788bdf6/c20d5eb0405dde28.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/107815/5/4768/276947/5e257548Ee42f500c/0ba8cd264bd603a3.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/95922/19/10937/254828/5e257549Eaad6ebf6/7d1400f5908cb55e.jpg" ></p><p><img src="https://img30.360buyimg.com/popWaterMark/jfs/t1/18297/2/6243/210375/5c5019eeE98403891/9b5ab2294d1ba205.jpg"><br></p><p><img src="https://img30.360buyimg.com/popWaterMark/jfs/t1/27804/18/6412/176509/5c5019eeE5e96f053/a189a00b486e911f.jpg"><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/96858/36/10825/132522/5e2575aaE6e19013f/fcb7fb8fd4943401.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/99976/27/10982/138934/5e2575afEc3a3592a/e17eb9f780781060.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/96877/26/10975/138715/5e25756dE20b8140b/19ae8dc80c60e881.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/98449/30/11083/55082/5e25756dE88f3074f/7616bc2265b4432c.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/95543/21/10832/67134/5e25756eE012754e2/70f82adbaa11adee.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/94888/33/11004/95067/5e25756eE02e81061/61480afaef4c3b86.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/108065/10/4797/103705/5e25756eEebecd8f5/65e124bd694bc55b.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/85920/26/11004/124810/5e25756eEa5644682/8fbaea1d59e5be77.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/84849/11/11057/55611/5e25756eE9f2527d0/83d5811a3712f5fd.jpg" ><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/90594/7/11010/137361/5e25756eE5d4d543c/61e96678694e5ba5.jpg"  class=""><img src="http://img30.360buyimg.com/popWaterMark/jfs/t1/85156/23/10917/211412/5e2546caEbf42fae5/5e494f3c805915e6.jpg" ></p><p><br></p><br/>",
		"desc_img": [
			"https://img10.360buyimg.com/imgzone/jfs/t1/38380/20/8577/216030/5cfdcf2eE3d3c15fc/9072ee4986b3f8d4.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t11302/317/3187030400/282664/5886b268/5ce3c383N6572b1da.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t29380/248/1583857170/211757/8803264c/5ce3c383Nf658d385.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/109234/40/8433/163092/5e6764a2E4e1a8595/47322c3588d6d0c8.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/89006/11/14706/167699/5e6764a2E68bdab3a/be235af214561ca7.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/109389/11/8312/121412/5e6764a2E0699edcb/74e48d00298808af.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/93399/24/14627/132014/5e6764a3E0f078e8e/8598eb9176d64a6c.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/107443/10/8345/114390/5e6764a3Ea1726cee/45cfa1a0f7a8df0c.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/96343/40/10991/241473/5e257548Ed6f96ea3/b52ab120eb9f7db0.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/101185/7/11047/209310/5e257548E8788bdf6/c20d5eb0405dde28.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/107815/5/4768/276947/5e257548Ee42f500c/0ba8cd264bd603a3.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/95922/19/10937/254828/5e257549Eaad6ebf6/7d1400f5908cb55e.jpg",
			"https://img30.360buyimg.com/popWaterMark/jfs/t1/18297/2/6243/210375/5c5019eeE98403891/9b5ab2294d1ba205.jpg",
			"https://img30.360buyimg.com/popWaterMark/jfs/t1/27804/18/6412/176509/5c5019eeE5e96f053/a189a00b486e911f.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/96858/36/10825/132522/5e2575aaE6e19013f/fcb7fb8fd4943401.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/99976/27/10982/138934/5e2575afEc3a3592a/e17eb9f780781060.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/96877/26/10975/138715/5e25756dE20b8140b/19ae8dc80c60e881.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/98449/30/11083/55082/5e25756dE88f3074f/7616bc2265b4432c.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/95543/21/10832/67134/5e25756eE012754e2/70f82adbaa11adee.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/94888/33/11004/95067/5e25756eE02e81061/61480afaef4c3b86.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/108065/10/4797/103705/5e25756eEebecd8f5/65e124bd694bc55b.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/85920/26/11004/124810/5e25756eEa5644682/8fbaea1d59e5be77.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/84849/11/11057/55611/5e25756eE9f2527d0/83d5811a3712f5fd.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/90594/7/11010/137361/5e25756eE5d4d543c/61e96678694e5ba5.jpg",
			"http://img30.360buyimg.com/popWaterMark/jfs/t1/85156/23/10917/211412/5e2546caEbf42fae5/5e494f3c805915e6.jpg"
		],
		"item_imgs": [
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/161425/26/11624/223402/6048750bE7b82f057/24b57f419c846302.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/37130/8/15667/153389/6011201bEb50bd760/f2d1ffe7ebad9436.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/164674/37/4551/170984/6011201bE0e613da2/440557c2c95a91d4.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/154416/30/16507/145178/6011201bEfa34047a/4bf1640b33cf9315.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/153609/29/16131/158270/6011201dEf430dc42/44d9310a57b910db.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/170321/31/4510/73278/6011201dEb0a321ee/4ab66e6bd5d24731.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/160893/36/4563/34735/6011201cEbc4782b3/421e58e83e287d8d.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/155392/21/16258/78051/6011201dEdbefbd4e/eb0bf02a39124ec5.jpg"
			},
			{
				"url": "//img10.360buyimg.com/n1/jfs/t1/85750/15/5753/82208/5def45a5E8bfae67b/5d6983c1a9b2dc81.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "福建泉州市",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "",
		"props_name": "0:0:尺码:43;0:1:尺码:42;0:2:尺码:39;0:3:尺码:40;0:4:尺码:44.5;0:5:尺码:40.5;0:6:尺码:41;0:7:尺码:42.5;1:0:颜色:-19黑;1:1:颜色:-6安踏白;1:2:颜色:-1黑/大红/安踏白;1:3:颜色:-5黑【推荐】;1:4:颜色:-3黑/安踏白;1:5:颜色:-4二度灰/亚麻灰/安踏白;1:6:颜色:-18黑【皮面】",
		"prop_imgs": {
			"prop_img": [
				{
					"properties": "1:0",
					"url": "//img14.360buyimg.com/n1/jfs/t1/167443/5/11561/189395/60487513E67e1ac89/6f2b0e24a15d2a07.jpg"
				},
				{
					"properties": "1:1",
					"url": "//img10.360buyimg.com/n1/jfs/t1/161425/26/11624/223402/6048750bE7b82f057/24b57f419c846302.jpg"
				},
				{
					"properties": "1:2",
					"url": "//img13.360buyimg.com/n1/jfs/t1/170137/21/11570/221223/6048750eE6f37af3b/485bda2785ac1eeb.jpg"
				},
				{
					"properties": "1:3",
					"url": "//img12.360buyimg.com/n1/jfs/t1/166580/14/11814/282234/60487510E28b9a6a6/7276dcf61be1c212.jpg"
				},
				{
					"properties": "1:4",
					"url": "//img10.360buyimg.com/n1/jfs/t1/166198/6/11018/211129/6048750eEe91f12ae/fc70a6a6c9119278.jpg"
				},
				{
					"properties": "1:5",
					"url": "//img13.360buyimg.com/n1/jfs/t1/159863/10/12700/269705/60487512Ed2c190a7/d3e41f7e3f809632.jpg"
				},
				{
					"properties": "1:6",
					"url": "//img14.360buyimg.com/n1/jfs/t1/170113/38/11563/205655/6048750cEa69d1123/61dfb5929923dd6f.jpg"
				}
			]
		},
		"property_alias": "0:0:43;0:1:42;0:2:39;0:3:40;0:4:44.5;0:5:40.5;0:6:41;0:7:42.5;1:0:-19黑;1:1:-6安踏白;1:2:-1黑/大红/安踏白;1:3:-5黑【推荐】;1:4:-3黑/安踏白;1:5:-4二度灰/亚麻灰/安踏白;1:6:-18黑【皮面】",
		"props": [
			{
				"name": "商品名称",
				"value": "安踏男鞋休闲运动鞋男士2021春季网面透气轻便板鞋慢跑步鞋子户外训练旅游 -6安踏白 42"
			},
			{
				"name": "商品编号",
				"value": "10335871600"
			},
			{
				"name": "店铺",
				"value": "安踏悠购专卖店"
			},
			{
				"name": "商品毛重",
				"value": "400.00g"
			},
			{
				"name": "商品产地",
				"value": "中国大陆"
			},
			{
				"name": "货号",
				"value": "安踏1"
			},
			{
				"name": "鞋面材质",
				"value": "网布"
			},
			{
				"name": "类别",
avatar
文章
阅读
粉丝