API接口获取商品详情数据

        API( Application Programming Interface ),我想大家不会陌生,它是我们Windows编程的常客,虽然基于.Net平台的C#有了强大的类库,但是,我们还是不能否认API在Windows编程中的重要性.大多数的编程语言都支持API编程,而.Net平台中的MFC(Microsoft Foundation Class Library)构架本身就封装了大部分的API。

1、公共参数

请求地址: https://api-gw.onebound.cn/dangdang/item_get

名称	类型	必须	描述
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版本

2、请求参数

请求参数：num_iid=25122027

参数说明：num_iid:EBAY商品ID

3、响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	25122027	宝贝ID
title	String	0	朗读者（1-3辑）（荣获2017年度大众喜爱的50种图书）	宝贝标题
desc_short	String	0		商品简介
promotion_price	Float	0	156.00	优惠价
price	Float	0	156.00	价格
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	Float	0	156.00	原价
nick	String	0	当当自营	掌柜昵称
num	Int	0
min_num	Int	0	0
detail_url	String	0	http://product.dangdang.com/25122027.html	宝贝链接
pic_url	String	0	http://img3m7.ddimg.cn/84/26/25122027-1_w_7.jpg	宝贝图片
brand	String	0		品牌名称
brandId	Int	0		品牌ID
rootCatId	Int	0		顶级分类ID
cid	Int	0
favcount	Int	0	0
fanscount	Int	0	0
crumbs	Mix	0
created_time	String	0
modified_time	String	0
delist_time	String	0
desc	String	0
item_imgs	Mix	0	[{ "url": "http://img3m7.ddimg.cn/84/26/25122027-1_w_7.jpg"}]	商品图片
item_weight	String	0
item_size	String	0
location	String	0		发货地
express_fee	Float	0	6.00	快递费用
ems_fee	Float	0	6.00	EMS费用
post_fee	Float	0	6.00	物流费用
shipping_to	String	0		发货至
has_discount	Boolean	0	false
video	Mix	0	[{}]	商品视频
is_virtual	String	0
sample_id	String	0		商品风格标识ID
is_promotion	Boolean	0	false
props_name	String	0	1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;	商品属性名
prop_imgs	Mix	0	{"prop_img": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"}]}	商品属性图片列表
property_alias	String	0	20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色	商品属性别名
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品详情
total_sold	Int	0
skus	Mix	0	{"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "1627207:1347647754", "properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子", "quantity": "305", "sku_id": "3166598625985"}]	商品规格信息
seller_id	Int	0	2844096782	卖家ID
sales	Int	0	138	销量
shop_id	Bigint	0	151372205	店铺ID
props_list	Mix	0	{20509:9974422: 尺码:36}	商品属性
seller_info	Mix	0	{"nick": "欢乐购客栈", "city": null, "level": 12, "bail": "2000", "rate": 96, "score": "4.8", "delivery_score": "4.8", "item_score": "4.8", "shop_type": null, "user_num_id": "2596264565", "sid": "127203758", "title": "欢乐购客栈", "zhuy": "//shop127203758.taobao.com", "company_name": null, "menu": [] }	卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0	price_json error;skus miss;	警告信息
url_log	Mix	0	[]
method	String	0	item_tmall:pget_item
promo_type	String	0
props_img	Mix	0	1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg	属性图片
shop_item	Mix	0	[]
relate_items	Mix	0	[]

4、请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

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

}