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

待我称王封你为后i 2024-03-22 17:43 22阅读 0赞

###  ###

### item\_get-获得微店商品详情 ###

#### micro.item\_get ####

开发背景：

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

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

通过使用这个API，商家可以更加方便快捷地管理和推广自己的商品，也可以提高用户的购买体验和满意度，进而增加销售额和商家收益。另外，这个API还能够为微店提供更加灵活可控的数据管理和安全保障，为平台的发展壮大提供有力保障。

公共参数

<table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>key</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用key（必须以GET方式拼接在URL中）</td> 
 </tr> 
 <tr> 
 <td>secret</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用密钥</td> 
 </tr> 
 <tr> 
 <td>api_name</td> 
 <td>String</td> 
 <td>是</td> 
 <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td>cache</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td>result_type</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td>lang</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td>version</td> 
 <td>String</td> 
 <td>否</td> 
 <td>API版本</td> 
 </tr> 
 </tbody> 
</table>

请求参数

请求参数：num\_iid=2749499386

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

响应参数

Version: Date:

<table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>示例值</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> num_iid </td> 
 <td>Bigint</td> 
 <td>0</td> 
 <td>2749499386</td> 
 <td>宝贝ID</td> 
 </tr> 
 <tr> 
 <td> title </td> 
 <td>String</td> 
 <td>0</td> 
 <td>Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082</td> 
 <td>宝贝标题</td> 
 </tr> 
 <tr> 
 <td> desc_short </td> 
 <td>String</td> 
 <td>0</td> 
 <td>Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082</td> 
 <td>商品简介</td> 
 </tr> 
 <tr> 
 <td> price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>45</td> 
 <td>价格</td> 
 </tr> 
 <tr> 
 <td> total_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> suggestive_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> orginal_price </td> 
 <td>String</td> 
 <td>0</td> 
 <td>45</td> 
 <td>原价</td> 
 </tr> 
 <tr> 
 <td> nick </td> 
 <td>String</td> 
 <td>0</td> 
 <td>达薇妮珠宝</td> 
 <td>掌柜昵称</td> 
 </tr> 
 <tr> 
 <td> num </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>库存</td> 
 </tr> 
 <tr> 
 <td> min_num </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>0</td> 
 <td>最小购买数</td> 
 </tr> 
 <tr> 
 <td> detail_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>https://weidian.com/item.html?itemID=2749499386</td> 
 <td>宝贝链接</td> 
 </tr> 
 <tr> 
 <td> pic_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg</td> 
 <td>宝贝图片</td> 
 </tr> 
 <tr> 
 <td> brand </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>品牌名称</td> 
 </tr> 
 <tr> 
 <td> brandId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>品牌ID</td> 
 </tr> 
 <tr> 
 <td> rootCatId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>顶级分类ID</td> 
 </tr> 
 <tr> 
 <td> cid </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> crumbs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td>导航菜单</td> 
 </tr> 
 <tr> 
 <td> created_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> modified_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> delist_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> desc </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品详情</td> 
 </tr> 
 <tr> 
 <td> desc_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg]</td> 
 <td>商品详情图片</td> 
 </tr> 
 <tr> 
 <td> item_imgs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[{ "url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg"}</td> 
 <td>商品图片</td> 
 </tr> 
 <tr> 
 <td> item_weight </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> item_size </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> location </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>发货地</td> 
 </tr> 
 <tr> 
 <td> express_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0.00</td> 
 <td>快递费用(该接口仅提供预估运费,准确需调用运费接口)</td> 
 </tr> 
 <tr> 
 <td> ems_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td></td> 
 <td>EMS费用(该接口仅提供预估运费,准确需调用运费接口)</td> 
 </tr> 
 <tr> 
 <td> post_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td></td> 
 <td>物流费用(该接口仅提供预估运费,准确需调用运费接口)</td> 
 </tr> 
 <tr> 
 <td> shipping_to </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>发货至</td> 
 </tr> 
 <tr> 
 <td> has_discount </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td>false</td> 
 <td>是否有优惠</td> 
 </tr> 
 <tr> 
 <td> video </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>]</td> 
 <td>商品视频</td> 
 </tr> 
 <tr> 
 <td> is_virtual </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> sample_id </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品风格标识ID</td> 
 </tr> 
 <tr> 
 <td> is_promotion </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td>false</td> 
 <td>是否促销</td> 
 </tr> 
 <tr> 
 <td> props_name </td> 
 <td>String</td> 
 <td>0</td> 
 <td>0:561195188:项链:流苏蝴蝶结项链;</td> 
 <td>商品属性名</td> 
 </tr> 
 <tr> 
 <td> prop_imgs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"prop_img": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"}]}</td> 
 <td>商品属性图片列表</td> 
 </tr> 
 <tr> 
 <td> property_alias </td> 
 <td>String</td> 
 <td>0</td> 
 <td>20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色</td> 
 <td>商品属性别名</td> 
 </tr> 
 <tr> 
 <td> props </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[{ "name": "产地","value": "中国" }]</td> 
 <td>商品属性</td> 
 </tr> 
 <tr> 
 <td> total_sold </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> skus </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"sku": [{"price": "39", "orginal_price": "39.00", "properties": "0:561195188;", "properties_name": "0:561195188:项链:流苏蝴蝶结项链;", "quantity": "305", "sku_id": "10668572309"}]</td> 
 <td>商品规格信息列表</td> 
 </tr> 
 <tr> 
 <td> seller_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>卖家ID</td> 
 </tr> 
 <tr> 
 <td> sales </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>138</td> 
 <td>销量</td> 
 </tr> 
 <tr> 
 <td> shop_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>1288244399</td> 
 <td>店铺ID</td> 
 </tr> 
 <tr> 
 <td> props_list </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"0:561195188": "项链:流苏蝴蝶结项链"}</td> 
 <td>商品属性</td> 
 </tr> 
 <tr> 
 <td> seller_info </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{ "title": "达薇妮珠宝", "shop_name":"达薇妮珠宝", "zhuy": "https://weidian.com/?userid=1288244399","level": 3, "shop_type": 3, "user_num_id": "1288244399", "nick": "达薇妮珠宝" }</td> 
 <td>卖家信息</td> 
 </tr> 
 <tr> 
 <td> tmall </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td>false</td> 
 <td>是否天猫</td> 
 </tr> 
 <tr> 
 <td> error </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>错误信息</td> 
 </tr> 
 <tr> 
 <td> warning </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>警告信息</td> 
 </tr> 
 <tr> 
 <td> url_log </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> favcount </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> fanscount </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> method </td> 
 <td>String</td> 
 <td>0</td> 
 <td>item_tmall:pget_item</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> promo_type </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> props_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg</td> 
 <td>属性图片</td> 
 </tr> 
 <tr> 
 <td> shop_item </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> relate_items </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 </tbody> 
</table>

请求示例

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

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

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