微店API分享：获得微店商品详情 API 返回值说明

item_get-获得微店商品详情

micro.item_get

开发背景：

    随着移动互联网和电子商务的迅猛发展，微店成为了越来越多小微商家的选择，开展网络销售。为了帮助这些商家更好地展示和推广自己的商品，微店需要开发一个商品详情API。

这个API可以让商家向平台上传商品的详细信息，包括商品名称、价格、运费、重量、库存、图片等等信息。同时也支持商家修改和更新这些信息，以保证商品在不同时间段内的最新和准确性。

通过使用这个API，商家可以更加方便快捷地管理和推广自己的商品，也可以提高用户的购买体验和满意度，进而增加销售额和商家收益。另外，这个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=2749499386

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

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	2749499386	宝贝ID
title	String	0	Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082	宝贝标题
desc_short	String	0	Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082	商品简介
price	Float	0	45	价格
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	String	0	45	原价
nick	String	0	达薇妮珠宝	掌柜昵称
num	Int	0		库存
min_num	Int	0	0	最小购买数
detail_url	String	0	https://weidian.com/item.html?itemID=2749499386	宝贝链接
pic_url	String	0	https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg	宝贝图片
brand	String	0		品牌名称
brandId	Int	0		品牌ID
rootCatId	Int	0		顶级分类ID
cid	Int	0
crumbs	Mix	0	[]	导航菜单
created_time	String	0
modified_time	String	0
delist_time	String	0
desc	String	0		商品详情
desc_img	Mix	0	[https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg]	商品详情图片
item_imgs	Mix	0	[{ "url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg"}	商品图片
item_weight	String	0
item_size	String	0
location	String	0		发货地
express_fee	Float	0	0.00	快递费用(该接口仅提供预估运费,准确需调用运费接口)
ems_fee	Float	0		EMS费用(该接口仅提供预估运费,准确需调用运费接口)
post_fee	Float	0		物流费用(该接口仅提供预估运费,准确需调用运费接口)
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	0:561195188:项链:流苏蝴蝶结项链;	商品属性名
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", "orginal_price": "39.00", "properties": "0:561195188;", "properties_name": "0:561195188:项链:流苏蝴蝶结项链;", "quantity": "305", "sku_id": "10668572309"}]	商品规格信息列表
seller_id	Int	0		卖家ID
sales	Int	0	138	销量
shop_id	Int	0	1288244399	店铺ID
props_list	Mix	0	{"0:561195188": "项链:流苏蝴蝶结项链"}	商品属性
seller_info	Mix	0	{ "title": "达薇妮珠宝", "shop_name":"达薇妮珠宝", "zhuy": "https://weidian.com/?userid=1288244399","level": 3, "shop_type": 3, "user_num_id": "1288244399", "nick": "达薇妮珠宝" }	卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0	[]
favcount	Int	0	0
fanscount	Int	0	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	[]

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理

curl -i "https://api-服务器.cn/micro/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=2749499386"

对电商API调用感兴趣的朋友，欢迎评论区或私信交流！