学习目标：

快速掌握接口的使用
亚马逊的API开发接口，我们需要做下面几件事情。
1）开放平台注册开发者账号；
2）然后为每个淘宝应用注册一个应用程序键（App Key) ；
3）下载亚马逊API的SDK并掌握基本的API基础知识和调用；
4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发；
5）利用亚马逊平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取

学习内容：

item_get-获得AMAZON商品详情 [查看演示] API测试工具注册开通

onebound.amazon.item_get

公共参数

请求地址: https://api-gw.onebound.cn/amazon/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=B016LO4UTA

参数说明：num_iid:AMAZON商品ID（非.cn的请在后加 -com）

响应参数

Version: Date:

名称	类型	示例值	描述
detail_url	String	https://www.amazon.cn/dp/B014QN8RG0?th=1&psc=1	商品链接
crumbs	Mix	{"162371071": "徒步鞋、登山鞋", "2029189051": "鞋靴", "2112046051": "男鞋", "2112064051": "运动户外鞋"}	导航列表
num_iid	String	B014QN8RG0	商品ID
title	String	Topsky 远行客户外登山鞋男鞋耐磨越野跑鞋低帮爬山轻便徒步鞋防滑户外鞋子休闲透气运动鞋 21907A	商品标题
desc_short	String	秋冬新款热销推荐	商品简介
brand	String		品牌名称
brandId	Bigint		品牌ID
rootCatId	Bigint	2029189051	顶级分类ID
cid	Bigint	162371071
star	Int	4
item_imgs	Mix	[{"url": "https://images-cn-4.ssl-images-amazon.com/images/I/51xKSHKPrqL.jpg"}]	商品图片
nick	String	Topsky 远行客	卖家昵称
num	Int	99
pic_url	String	//images-cn-4.ssl-images-amazon.com/images/I/61svv4xXUVL._SX466_.jpg	商品图片
currency_code	String	CNY	当前货币代码
price	Float	269.00	价格
orginal_price	Float	269.00	原价
type	String
seller_cids	String
input_pids	String
input_str	String
item_weight	String
valid_thru	String
delist_time	String
stuff_status	String
location	String		发货地
express_fee	Float		快递费用
ems_fee	Float		EMS费用
post_fee	Float		物流费用
shipping_to	String		发货至
has_discount	String
freight_payer	String
has_invoice	String
has_warranty	String
has_showcase	String
increment	String
approve_status	String
postage_id	String
product_id	String
auction_point	String
item_img	String
prop_imgs	Mix	{"prop_img": []}	商品属性图片列表
props_img	Mix	{}
video	Mix	[]	商品视频
outer_id	String
is_virtual	String
sample_id	String		商品风格标识ID
is_promotion	String
props_name	String	0:1:尺寸:40;0:0:尺寸:39;1:4:颜色:;1:2:颜色:;1:0:颜色:军绿色;1:3:颜色:;1:1:颜色:深褐色;1:5:颜色:	商品属性名
property_alias	String	0:1:40;1:4:;0:1:40;1:2:;0:0:39;1:0:军绿色;0:1:40;1:3:;0:1:40;1:1:深褐色;0:1:40;1:0:军绿色;0:0:39;1:5:;0:0:39;1:4:;0:0:39;1:3:;0:1:40;1:5:	商品属性别名
seller_id	Bigint		卖家ID
shop_id	Bigint		店铺ID
props_list	Mix	{"0:1": "尺寸:40", 1:0": "颜色:军绿色}	商品属性列表
seller_info	Mix	{"nick": "Topsky 远行客", "city": "", "bail": "", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "1", "sid": "1", "title": "Topsky 远行客", "zhuy": "https://www.amazon.cn/", "company_name": "", "menu": []}	卖家信息
tmall	Boolean		是否天猫
error	String		错误信息
warning	String		警告信息
url_log	String
shopinfo	Mix	{"shop_name": ""}	店铺信息
promo_type	String
shop_item	Mix	[]
relate_items	Mix	[]
sku	Mix	{"sku": [{"price": "269.00", "orginal_price": "269.00", "properties": "0:1;1:4", "properties_name": "0:1:尺寸:40;1:4:颜色:", "quantity": 0, "sku_id": "B014QN8VFM", "sku_url": "https://www.amazon.cn/dp/B014QN8VFM?th=1&psc=1"}]}	商品规格信息列表
desc	String
pinglun	Mix	[]

Result Object:
---------------------------------------
{
 "item": {
 "detail_url": "https://www.amazon.cn/dp/B00AD69V0G?th=1&psc=1",
 "crumbs": {
 "111082071": "鞋油",
 "162417071": "鞋靴配件",
 "2029189051": "鞋靴"
 },
 "title": "ECCO 爱步鞋子清新剂 60ml 适用于成人鞋",
 "desc_short": "",
 "brand": "",
 "brandId": "",
 "end_time": "",
 "rootCatId": "2029189051",
 "cid": "111082071",
 "star": "4-5",
 "item_imgs": [
 {
 "url": "https://images-cn.ssl-images-amazon.cn/images/I/31Z7eT+zbdL._AC_.jpg"
 },
 {
 "url": "https://images-cn.ssl-images-amazon.cn/images/I/41dN-48bR9L._AC_.jpg"
 },
 {
 "url": "https://images-cn.ssl-images-amazon.cn/images/I/31olu7zqgSL._AC_.jpg"
 },
 {
 "url": "https://images-cn.ssl-images-amazon.cn/images/I/219q8guWI9L._AC_.jpg"
 }
 ],
 "nick": "ECCO 爱步",
 "num": "99",
 "num_iid": "B00AD69V0G",
 "pic_url": "//images-cn.ssl-images-amazon.cn/images/I/71yOBn-qbZL._AC_UY395_.jpg",
 "currency_code": "CNY",
 "price": "¥116.04",
 "orginal_price": "¥116.04",
 "location": "",
 "item_weight": "\n \n &lrm",
 "item_size": "&rlm",
 "post_fee": "",
 "express_fee": "",
 "prop_imgs": {
 "prop_img": [
 {
 "properties": "1:0",
 "url": null
 }
 ]
 },
 "props_img": {
 "1:0": null
 },
 "props_name": "0:0:尺寸:40 EU/5 M US;1:0:颜色:透明",
 "property_alias": "0:0:40 EU/5 M US;1:0:透明",
 "props_list": {
 "0:0": "尺寸:40 EU/5 M US",
 "1:0": "颜色:透明"
 },
 "seller_info": {
 "nick": "ECCO 爱步",
 "city": "",
 "bail": "",
 "level": "",
 "rate": "",
 "score": "",
 "delivery_score": "",
 "item_score": "",
 "shop_type": "",
 "user_num_id": "1",
 "sid": "1",
 "title": "ECCO 爱步",
 "zhuy": "https://www.amazon.cn/",
 "company_name": "",
 "menu": []
 },
 "error": "",
 "warning": "",
 "shopinfo": {
 "shop_name": ""
 },
 "shop_item": [],
 "relate_items": [],
 "skus": {
 "sku": [
 {
 "price": "¥116.04",
 "orginal_price": "¥116.04",
 "properties": "0:0;1:0",
 "properties_name": "0:0:尺寸:40 EU/5 M US;1:0:颜色:透明",
 "quantity": 99,
 "sku_id": "B00AD69V0G",
 "sku_url": "https://www.amazon.cn/dp/B00AD69V0G?th=1&psc=1"
 }
 ]
 },
 "desc": "<div> \n </div> <img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.62d0e0e9caa5a&p=1778787841&k=i_key&t=1657856236\" style=\"display:none\" />",
 "pinglun": [
 {
 "star": "5",
 "title": "Good",
 "author": "World shopper",
 "time": "2019年11月20日",
 "choose": "尺寸: 40 EU/5 M US颜色: 透明",
 "content": "It's working good."
 },
 {
 "star": "5",
 "title": "For inside of shoes",
 "author": "WsZ",
 "time": "2018年11月28日",
 "choose": "尺寸: 40 EU/5 M US颜色: 透明",
 "content": "In think it works well. Actually I bought it because the recommendation on the web and that I can't wash my leather boots."
 },
 {
 "star": "5",
 "title": "Five Stars",
 "author": "Aries",
 "time": "2014年11月2日",
 "choose": "尺寸: 40 EU/5 M US颜色: 透明",
 "content": "very good"
 },
 {
 "star": "5",
 "title": "Five Stars",
 "author": "Song Chao",
 "time": "2014年10月30日",
 "choose": "尺寸: 40 EU/5 M US颜色: 透明",
 "content": "GOOD"
 },
 {
 "star": "1",
 "title": "One Star",
 "author": "Jarno Mossou",
 "time": "2018年8月23日",
 "choose": "尺寸: 40 EU/5 M US颜色: 透明",
 "content": "It is not working for me"
 }
 ],
 "format_check": "ok",
 "sales": 0,
 "desc_img": []
 },
 "error": "",
 "secache": "65dffdee32e84d2c72cdac09805d947f",
 "secache_time": 1657856236,
 "secache_date": "2022-07-15 11:37:16",
 "translate_status": "",
 "translate_time": 0,
 "language": {
 "default_lang": "cn",
 "current_lang": "cn"
 },
 "reason": "",
 "error_code": "0000",
 "cache": 0,
 "api_info": "today:24 max:10100 all[65=24+24+17];expires:2030-12-31",
 "execution_time": "2.263",
 "server_time": "Beijing/2022-07-15 11:37:16",
 "client_ip": "106.6.38.1",
 "call_args": {
 "num_iid": "B00AD69V0G"
 },
 "api_type": "amazon",
 "translate_language": "zh-CN",
 "translate_engine": "google_cn",
 "server_memory": "4.18MB",
 "request_id": "gw-1.62d0e0e9caa5a",
 "last_id": "1079188430"
}

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否