淘宝/天猫平台上,获取SKU(Stock Keeping Unit)的详细信息可以使用淘宝开放平台(Taobao Open Platform)提供的API接口。淘宝开放平台提供了一系列API接口,允许开发人员访问淘宝/天猫的数据和功能。
流程概述:
- 注册开发平台账号:首先,你需要在开放平台注册一个开发者账号。
- 创建应用:获取App Key和App Secret。
- 调用API:使用App Key和App Secret生成签名,然后调用相关的API接口。
公共参数:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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=572050066584&sku_id=3880971359554&is_promotion=0
参数说明:sku_id:SKU ID
num_iid:商品ID
is_promotion:是否获取取促销价
请求示例:
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.fan-b.com/taobao/item_sku/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=572050066584&sku_id=3880971359554&is_promotion=0";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
返回值参考:
{
"item": {
"num_iid": "722328050704",
"item_name": "拖鞋情侣家居一对浴室洗澡防滑托鞋女士夏季室内家用时尚外穿凉拖",
"item_url": "https://item.taobao.com/item.htm?id=722328050704",
"cat_id": 50009049,
"root_cat_id": "",
"cat_name": {
"items": {
"item": [
{
"id": "50009049",
"name": "鞋带",
"pid": "50009045",
"root_id": "50010404",
"sub": null
}
]
}
},
"root_cat_name": {
"items": {
"item": [
{
"id": "1",
"pid": "0",
"root_id": "0",
"name": "游戏话费",
"note": "virtual"
},
{
"id": "2",
"pid": "0",
"root_id": "0",
"name": "服装鞋包",
"note": "virtual"
},
{
"id": "3",
"pid": "0",
"root_id": "0",
"name": "手机数码",
"note": "virtual"
},
{
"id": "4",
"pid": "0",
"root_id": "0",
"name": "家用电器",
"note": "virtual"
},
{
"id": "5",
"pid": "0",
"root_id": "0",
"name": "美妆饰品",
"note": "virtual"
},
{
"id": "6",
"pid": "0",
"root_id": "0",
"name": "母婴用品",
"note": "virtual"
},
{
"id": "7",
"pid": "0",
"root_id": "0",
"name": "家居建材",
"note": "virtual"
},
{
"id": "8",
"pid": "0",
"root_id": "0",
"name": "百货食品",
"note": "virtual"
},
{
"id": "9",
"pid": "0",
"root_id": "0",
"name": "运动户外",
"note": "virtual"
},
{
"id": "10",
"pid": "0",
"root_id": "0",
"name": "文化玩乐",
"note": "virtual"
},
{
"id": "12",
"pid": "0",
"root_id": "0",
"name": "其他商品",
"note": ""
},
{
"id": "13",
"pid": "0",
"root_id": "0",
"name": "汽配摩托",
"note": "virtual"
},
{
"id": "98",
"pid": "0",
"root_id": "0",
"name": "包装",
"note": ""
},
{
"id": "2128",
"pid": "0",
"root_id": "0",
"name": "已删除",
"note": ""
},
{
"id": "50004958",
"pid": "0",
"root_id": "0",
"name": "移动/联通/电信充值中心",
"note": ""
},
{
"id": "50007216",
"pid": "0",
"root_id": "0",
"name": "鲜花速递/花卉仿真/绿植园艺",
"note": ""
},
{
"id": "50008075",
"pid": "0",
"root_id": "0",
"name": "餐饮美食卡券",
"note": ""
},
{
"id": "50008141",
"pid": "0",
"root_id": "0",
"name": "酒类",
"note": ""
},
{
"id": "50008907",
"pid": "0",
"root_id": "0",
"name": "手机号码/套餐/增值业务",
"note": ""
},
{
"id": "50014811",
"pid": "0",
"root_id": "0",
"name": "网店/网络服务/软件",
"note": ""
},
{
"id": "50014927",
"pid": "0",
"root_id": "0",
"name": "教育培训",
"note": ""
},
{
"id": "50017652",
"pid": "0",
"root_id": "0",
"name": "服务市场",
"note": ""
},
{
"id": "50019095",
"pid": "0",
"root_id": "0",
"name": "线下消费卡",
"note": ""
},
{
"id": "50023575",
"pid": "0",
"root_id": "0",
"name": "房产/租房/新房/二手房/委托服务",
"note": ""
},
{
"id": "50023717",
"pid": "0",
"root_id": "0",
"name": "互联网医疗/保健用品",
"note": ""
},
{
"id": "50023721",
"pid": "0",
"root_id": "0",
"name": "医疗器械",
"note": ""
},
{
"id": "50023722",
"pid": "0",
"root_id": "0",
"name": "隐形眼镜/护理液",
"note": ""
},
{
"id": "50023724",
"pid": "0",
"root_id": "0",
"name": "其他",
"note": ""
},
{
"id": "50023878",
"pid": "0",
"root_id": "0",
"name": "自用闲置转让",
"note": ""
},
{
"id": "50024153",
"pid": "0",
"root_id": "0",
"name": "计生用品",
"note": ""
},
{
"id": "50024186",
"pid": "0",
"root_id": "0",
"name": "保险",
"note": ""
},
{
"id": "50024612",
"pid": "0",
"root_id": "0",
"name": "阿里健康送药服务",
"note": ""
},
{
"id": "50025004",
"pid": "0",
"root_id": "0",
"name": "个性定制/设计服务/DIY",
"note": ""
},
{
"id": "50025110",
"pid": "0",
"root_id": "0",
"name": "电影/演出/体育赛事",
"note": ""
},
{
"id": "50025111",
"pid": "0",
"root_id": "0",
"name": "本地化生活服务",
"note": ""
},
{
"id": "50025618",
"pid": "0",
"root_id": "0",
"name": "理财",
"note": ""
},
{
"id": "50025968",
"pid": "0",
"root_id": "0",
"name": "司法拍卖拍品专用",
"note": ""
},
{
"id": "50026535",
"pid": "0",
"root_id": "0",
"name": "医疗及健康服务",
"note": ""
},
{
"id": "50026555",
"pid": "0",
"root_id": "0",
"name": "购物提货券",
"note": ""
},
{
"id": "50158001",
"pid": "0",
"root_id": "0",
"name": "网络店铺代金/优惠券",
"note": ""
},
{
"id": "50230002",
"pid": "0",
"root_id": "0",
"name": "服务商品",
"note": ""
},
{
"id": "50734010",
"pid": "0",
"root_id": "0",
"name": "资产",
"note": ""
},
{
"id": "50802001",
"pid": "0",
"root_id": "0",
"name": "数字阅读",
"note": ""
},
{
"id": "120886001",
"pid": "0",
"root_id": "0",
"name": "公益",
"note": ""
},
{
"id": "120894001",
"pid": "0",
"root_id": "0",
"name": "淘女郎",
"note": ""
},
{
"id": "120950002",
"pid": "0",
"root_id": "0",
"name": "天猫点券",
"note": ""
},
{
"id": "121266001",
"pid": "0",
"root_id": "0",
"name": "众筹",
"note": ""
},
{
"id": "121380001",
"pid": "0",
"root_id": "0",
"name": "机票/小交通/增值服务",
"note": ""
},
{
"id": "121536003",
"pid": "0",
"root_id": "0",
"name": "数字娱乐",
"note": ""
},
{
"id": "121536007",
"pid": "0",
"root_id": "0",
"name": "全球购代购市场",
"note": ""
},
{
"id": "121938001",
"pid": "0",
"root_id": "0",
"name": "淘点点预定点菜",
"note": ""
},
{
"id": "121940001",
"pid": "0",
"root_id": "0",
"name": "淘点点现金券",
"note": ""
},
{
"id": "122966004",
"pid": "0",
"root_id": "0",
"name": "处方药",
"note": ""
},
{
"id": "123500005",
"pid": "0",
"root_id": "0",
"name": "资产(政府类专用)",
"note": ""
},
{
"id": "123536002",
"pid": "0",
"root_id": "0",
"name": "阿里通信专属类目",
"note": ""
},
{
"id": "123690003",
"pid": "0",
"root_id": "0",
"name": "精制中药材",
"note": ""
},
{
"id": "124024001",
"pid": "0",
"root_id": "0",
"name": "农业生产资料(农村淘宝专用)",
"note": ""
},
{
"id": "124242008",
"pid": "0",
"root_id": "0",
"name": "智能设备",
"note": ""
},
{
"id": "124466001",
"pid": "0",
"root_id": "0",
"name": "农用物资",
"note": ""
},
{
"id": "124468001",
"pid": "0",
"root_id": "0",
"name": "农机/农具/农膜",
"note": ""
},
{
"id": "124470001",
"pid": "0",
"root_id": "0",
"name": "畜牧/养殖物资",
"note": ""
},
{
"id": "124470006",
"pid": "0",
"root_id": "0",
"name": "整车(经销商)",
"note": ""
},
{
"id": "124568010",
"pid": "0",
"root_id": "0",
"name": "室内设计师",
"note": ""
},
{
"id": "124698018",
"pid": "0",
"root_id": "0",
"name": "装修服务",
"note": ""
},
{
"id": "124750013",
"pid": "0",
"root_id": "0",
"name": "俪人购(俪人购专用)",
"note": ""
},
{
"id": "124844002",
"pid": "0",
"root_id": "0",
"name": "拍卖会专用",
"note": ""
},
{
"id": "124868003",
"pid": "0",
"root_id": "0",
"name": "盒马",
"note": ""
},
{
"id": "124912001",
"pid": "0",
"root_id": "0",
"name": "合约机",
"note": ""
},
{
"id": "125102006",
"pid": "0",
"root_id": "0",
"name": "到家业务",
"note": ""
},
{
"id": "125406001",
"pid": "0",
"root_id": "0",
"name": "享淘卡",
"note": ""
},
{
"id": "126252002",
"pid": "0",
"root_id": "0",
"name": "门店O2O",
"note": ""
},
{
"id": "126488005",
"pid": "0",
"root_id": "0",
"name": "天猫零售O2O",
"note": ""
},
{
"id": "126488008",
"pid": "0",
"root_id": "0",
"name": "阿里健康B2B平台",
"note": ""
},
{
"id": "126602002",
"pid": "0",
"root_id": "0",
"name": "生活娱乐充值",
"note": ""
},
{
"id": "126700003",
"pid": "0",
"root_id": "0",
"name": "家装灯饰光源",
"note": ""
},
{
"id": "126762001",
"pid": "0",
"root_id": "0",
"name": "美容美体仪器",
"note": ""
},
{
"id": "127076003",
"pid": "0",
"root_id": "0",
"name": "平台充值活动(仅内部店铺)",
"note": ""
},
{
"id": "127110013",
"pid": "0",
"root_id": "0",
"name": "疫苗服务",
"note": ""
},
{
"id": "127442006",
"pid": "0",
"root_id": "0",
"name": "纺织面料/辅料/配套",
"note": ""
},
{
"id": "127450004",
"pid": "0",
"root_id": "0",
"name": "金属材料及制品",
"note": ""
},
{
"id": "127452002",
"pid": "0",
"root_id": "0",
"name": "橡塑材料及制品",
"note": ""
},
{
"id": "127458007",
"pid": "0",
"root_id": "0",
"name": "搬运/仓储/物流设备",
"note": ""
},
{
"id": "127484003",
"pid": "0",
"root_id": "0",
"name": "润滑/胶粘/试剂/实验室耗材",
"note": ""
},
{
"id": "127492006",
"pid": "0",
"root_id": "0",
"name": "标准件/零部件/工业耗材",
"note": ""
},
{
"id": "127508003",
"pid": "0",
"root_id": "0",
"name": "机械设备",
"note": ""
},
{
"id": "127588002",
"pid": "0",
"root_id": "0",
"name": "阿里云云市场",
"note": ""
},
{
"id": "127876007",
"pid": "0",
"root_id": "0",
"name": "清洗/食品/商业设备",
"note": ""
},
{
"id": "127878006",
"pid": "0",
"root_id": "0",
"name": "新制造",
"note": ""
},
{
"id": "127882008",
"pid": "0",
"root_id": "0",
"name": "菜鸟驿站生活店",
"note": ""
},
{
"id": "127924022",
"pid": "0",
"root_id": "0",
"name": "零售通",
"note": ""
},
{
"id": "201136401",
"pid": "0",
"root_id": "0",
"name": "闲鱼优品",
"note": ""
},
{
"id": "201149009",
"pid": "0",
"root_id": "0",
"name": "旅行购物",
"note": ""
},
{
"id": "201156706",
"pid": "0",
"root_id": "0",
"name": "商务/设计服务",
"note": ""
},
{
"id": "201160314",
"pid": "0",
"root_id": "0",
"name": "口碑/饿了么本地生活",
"note": ""
},
{
"id": "201162107",
"pid": "0",
"root_id": "0",
"name": "汽车零部件/养护/美容/维保",
"note": ""
},
{
"id": "201173506",
"pid": "0",
"root_id": "0",
"name": "兑换卡",
"note": ""
},
{
"id": "201175701",
"pid": "0",
"root_id": "0",
"name": "淘小铺",
"note": ""
},
{
"id": "201207402",
"pid": "0",
"root_id": "0",
"name": "婴童尿裤",
"note": ""
},
{
"id": "201230407",
"pid": "0",
"root_id": "0",
"name": "体检/医疗保障卡",
"note": ""
},
{
"id": "201236409",
"pid": "0",
"root_id": "0",
"name": "店铺经营主体变更",
"note": ""
},
{
"id": "201273575",
"pid": "0",
"root_id": "0",
"name": "OTC药品/国际医药",
"note": ""
},
{
"id": "201304427",
"pid": "0",
"root_id": "0",
"name": "民生服务",
"note": ""
},
{
"id": "201307427",
"pid": "0",
"root_id": "0",
"name": "购物金",
"note": ""
},
{
"id": "201310232",
"pid": "0",
"root_id": "0",
"name": "能源出行",
"note": ""
},
{
"id": "201402901",
"pid": "0",
"root_id": "0",
"name": "商业加盟",
"note": ""
},
{
"id": "201412401",
"pid": "0",
"root_id": "0",
"name": "钉钉电商",
"note": ""
}
]
}
}
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:47 max:10000 all[2543=47+13+2483];expires:2030-10-30",
"execution_time": "1.732",
"server_time": "Beijing/2024-10-21 11:30:36",
"client_ip": "61.131.237.50",
"call_args": [],
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "",
"server_memory": "1.02MB",
"request_id": "gw-4.6715cada7c020",
"last_id": "3627693474"
}
注意事项
- API权限:确保已经申请并获得了调用相关API的权限。
- 签名:调用API时需要生成签名,确保请求的安全性。
- 错误处理:在实际应用中,需要添加更多的错误处理逻辑,以处理可能的异常情况。
- API版本:开放平台的API可能会更新,确保你使用的是最新的API文档和SDK。