API( Application Programming Interface ),我想大家不会陌生,它是我们Windows编程的常客,虽然基于.Net平台的C#有了强大的类库,但是,我们还是不能否认API在Windows编程中的重要性.大多数的编程语言都支持API编程,而.Net平台中的MFC(Microsoft Foundation Class Library)构架本身就封装了大部分的API。
请求地址: 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版本 |
请求参数:num_iid=25122027
参数说明:num_iid:EBAY商品ID
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 | [] |
- 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());
- }
-
- }