获得微店商品详情 API

万邦Noah
93 阅读5分钟

item_get-获得微店商品详情 注册开通测试

onebound.micro.item_get

公共参数

请求地址: api-gw.onebound.cn/micro/item_…

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快
result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
langString否[cn,en,ru]翻译语言，默认cn简体中文
versionString否API版本

请求参数

请求参数：num_iid=2749499386

参数说明：num_iid:微店商品ID\

响应参数

Version: Date:

名称类型必须示例值描述
num_iidBigint02749499386宝贝ID
titleString0Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082宝贝标题
desc_shortString0Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082商品简介
priceFloat045价格
total_priceFloat00
suggestive_priceFloat00
orginal_priceString045原价
nickString0达薇妮珠宝掌柜昵称
numInt0库存
min_numInt00最小购买数
detail_urlString0weidian.com/item.html?i…宝贝链接
pic_urlString0si.geilicdn.com/pcitem12882…宝贝图片
brandString0品牌名称
brandIdInt0品牌ID
rootCatIdInt0顶级分类ID
cidInt0
crumbsMix0[]导航菜单
created_timeString0
modified_timeString0
delist_timeString0
descString0商品详情
desc_imgMix0[si.geilicdn.com/pcitem12882…]商品详情图片
item_imgsMix0[{ "url": "si.geilicdn.com/pcitem12882…"}商品图片
item_weightString0
item_sizeString0
locationString0发货地
express_feeFloat00.00快递费用
ems_feeFloat0EMS费用
post_feeFloat0物流费用
shipping_toString0发货至
has_discountBoolean0false是否有优惠
videoMix0]商品视频
is_virtualString0
sample_idString0商品风格标识ID
is_promotionBoolean0false是否促销
props_nameString00:561195188:项链:流苏蝴蝶结项链;商品属性名
prop_imgsMix0{"prop_img": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"}]}商品属性图片列表
property_aliasString020509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色商品属性别名
propsMix0[{ "name": "产地","value": "中国" }]商品属性
total_soldInt0
skusMix0{"sku": [{"price": "39", "orginal_price": "39.00", "properties": "0:561195188;", "properties_name": "0:561195188:项链:流苏蝴蝶结项链;", "quantity": "305", "sku_id": "10668572309"}]商品规格信息列表
seller_idInt0卖家ID
salesInt0138销量
shop_idInt01288244399店铺ID
props_listMix0{"0:561195188": "项链:流苏蝴蝶结项链"}商品属性
seller_infoMix0{ "title": "达薇妮珠宝", "shop_name":"达薇妮珠宝", "zhuy": "weidian.com/?userid=128…": 3, "shop_type": 3, "user_num_id": "1288244399", "nick": "达薇妮珠宝" }卖家信息
tmallBoolean0false是否天猫
errorString0错误信息
warningString0警告信息
url_logMix0[]
favcountInt00
fanscountInt00
methodString0item_tmall:pget_item
promo_typeString0
props_imgMix01627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg属性图片
shop_itemMix0[]
relate_itemsMix0[]

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/micro/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=2749499386"

响应示例

{
  "item": {
		"num_iid": "2749499386",
		"title": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"desc_short": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"price": 45,
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "45",
		"nick": "达薇妮珠宝",
		"num": "",
		"min_num": 0,
		"detail_url": "https://weidian.com/item.html?itemID=2749499386",
		"pic_url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "",
		"favcount": "",
		"fanscount": "",
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<img src="https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg"/><img src="https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg"/>",
		"desc_img": [
			"https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg",
			"https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg",
			"https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg",
			"https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg",
			"https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg"
		],
		"item_imgs": [
			{
				"url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "false",
		"props_name": "0:561195188:项链:流苏蝴蝶结项链;",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "",
		"props": [],
		"total_sold": "0",
		"skus": {
			"sku": [
				{
					"price": "45.00",
					"orginal_price": "45.00",
					"properties": "0:561195188;",
					"properties_name": "0:561195188:项链:流苏蝴蝶结项链;:",
					"quantity": 957,
					"sku_id": 10668572309
				}
			]
		},
		"seller_id": "",
		"sales": 106,
		"shop_id": 1288244399,
		"props_list": [
			{
				"0:561195188": "项链:流苏蝴蝶结项链"
			}
		],
		"seller_info": {
			"title": "达薇妮珠宝",
			"shop_name": "达薇妮珠宝",
			"zhuy": "https://weidian.com/?userid=1288244399",
			"level": 3,
			"shop_type": 3,
			"user_num_id": 1288244399,
			"nick": "达薇妮珠宝"
		},
		"tmall": "false",
		"error": "",
		"warning": "",
		"url_log": [],
		"stuff_status": "",
		"data_from": "micro",
		"method": "",
		"promo_type": null,
		"props_img": null,
		"rate_grade": "",
		"priceRange": [],
		"shop_item": [],
		"relate_items": []
	},
	"secache": "bca4a25047d7b435e098ecb97efd77dd",
	"secache_time": 1611128224,
	"secache_date": "2021-01-20 15:37:04",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:0 max:10000",
	"execution_time": 3.061,
	"server_time": "Beijing/2021-01-20 15:37:04",
	"client_ip": "115.151.186.91",
	"call_args": {
		"num_iid": "2749499386",
		"area_id": "440111"
	},
	"api_type": "micro",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "2.75MB",
	"request_id": "1.6007dd9d4909b"
}

异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}

相关资料错误码解释

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