随着电子商务的快速发展,微店作为一个便捷、灵活的电商平台,为众多小微企业和个人提供了开设在线店铺的机会。为了更好地满足商家和开发者对商品信息的管理需求,微店提供了商品详情API接口。
一、API概述
微店商品详情API允许商家和开发者通过指定商品ID或其他参数,获取商品的详细信息。这些详细信息包括商品的名称、价格、库存、描述、图片等,是商家进行商品管理、展示和推广的重要依据。通过调用这一API接口,商家和开发者可以方便地获取所需商品信息,从而进行后续的操作和决策。
-
参数说明
-
通用参数说明
- version:API版本
- key:调用key,测试key:test_api_key
- api_name:API类型[item_search,item_get]
- cache:[yes,no]默认yes,将调用缓存的数据,速度比较快
- result_type:[json,xml,serialize,var_export]返回数据格式,默认为json
- lang:[cn,en,ru] 翻译语言,默认cn简体中文
-
API:item_search 参数说明: q:搜索关键词 cat:分类ID start_price:开始价格 end_price:结束价格 sort:排序 page:
-
API:item_get 参数说明: num_iid:商品id【num_iid=1520294】
-
-
此API目前支持以下基本接口:
- item_search 根据关键词取商品列表
- item_search_shop 获得店铺的所有商品
- item_get 获得微店商品详情
二、返回值结构
微店商品详情API的返回值通常为JSON格式,包含了多个字段。下面将逐一介绍这些字段的含义和重要性。
-
code:返回码。通常,返回码为0表示请求成功,非0值则代表不同的错误情况。在解析返回值时,首先需要检查这个字段的值,以确保请求成功。
-
message:与返回码对应的消息描述。如果请求成功,该字段通常包含“success”等描述性信息;如果请求失败,则包含具体的错误原因。
-
data:包含实际商品信息的字段。该字段下包含了商品的详细信息,如下所示:
- id:商品的唯一标识符。
- title:商品的名称或标题。
- price:商品的价格信息,包括原价、促销价等。
- stock:商品的库存数量。
- description:商品的详细描述,可能包含商品的特点、用途、尺寸等信息。
- images:商品的图片链接或URL列表,通常包括主图、详情图等。
- category_id:商品所属的分类ID。
- brand:商品的品牌信息。
- properties:商品的属性信息,如颜色、尺寸、材质等。这些属性可能因商品类别和商家设置的不同而有所差异。
除了上述基本信息外,data字段还可能包含其他与商品相关的扩展信息,如销量、评价、关联商品等。这些扩展信息可以根据具体的业务需求进行解析和应用。
-
micro.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版本
响应示例
{ "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": {
三、返回值解析与应用
在获取到微店商品详情API的返回值后,商家和开发者可以通过以下方式解析和应用这些数据:
-
商品信息展示:将获取到的商品信息展示在店铺页面、商品详情页等位置,供消费者浏览和购买。
-
商品管理:基于获取到的商品信息,商家可以进行库存管理、价格调整、上下架等操作,确保商品信息的准确性和实时性。
-
数据分析:通过分析商品信息中的销量、评价等数据,商家可以了解商品的销售情况和市场反馈,为后续的运营策略提供数据支持。
-
个性化推荐:根据用户的浏览和购买历史,结合商品信息中的属性、分类等信息,进行个性化推荐,提高用户的购物体验和转化率。
四、总结
微店商品详情API为商家和开发者提供了便捷的商品信息获取途径。通过解析其返回值,可以全面了解商品的详细信息,为商品管理、展示和推广提供有力支持。在利用这一功能时,需要注意检查返回码和消息描述,确保请求成功;同时,还需要根据具体的业务需求和应用场景选择合适的字段和属性进行解析和应用。