微店商品详情API接口指南微店商品详情API接口指南概述微店商品详情API允许开发者获取微店平台上商品的详细信息，包

微店商品详情API接口指南

概述

微店商品详情API允许开发者获取微店平台上商品的详细信息，包括商品基本信息、价格、库存、图片、规格等数据。

基础信息

接口地址：[https://api.weidian.com/v1/item/get]
请求方式：GET/POST
数据格式：JSON

请求参数

参数名	类型	必填	描述
method	String	是	固定值: `item.get`
access_token	String	是	授权令牌
item_id	String	是	商品ID
version	String	否	API版本号，默认为最新版本

响应参数

json

复制

下载

{
  "result": {
    "item_id": "商品ID",
    "title": "商品标题",
    "price": "商品价格(元)",
    "original_price": "原价(元)",
    "stock": "库存数量",
    "sold_num": "已售数量",
    "images": [
      "图片URL1",
      "图片URL2"
    ],
    "desc": "商品描述(HTML格式)",
    "sku_list": [
      {
        "sku_id": "SKU ID",
        "spec": "规格信息",
        "price": "规格价格",
        "stock": "规格库存"
      }
    ],
    "post_fee": "运费(元)",
    "is_on_sale": "是否在售(1-在售,0-下架)",
    "create_time": "创建时间",
    "update_time": "更新时间"
  },
  "status": {
    "status_code": 0,
    "status_reason": "成功"
  }
}

错误码

错误码	描述
0	成功
1001	参数错误
1002	商品不存在
1003	无权限访问该商品
2001	系统错误
3001	访问令牌无效

调用示例

请求示例

bash

复制

下载

curl -X GET "https://api.weidian.com/v1/item/get?method=item.get&access_token=YOUR_ACCESS_TOKEN&item_id=123456"

响应示例

json

复制

下载

{
  "result": {
    "item_id": "123456",
    "title": "示例商品",
    "price": "99.00",
    "original_price": "129.00",
    "stock": 100,
    "sold_num": 50,
    "images": [
      "https://img.weidian.com/1.jpg",
      "https://img.weidian.com/2.jpg"
    ],
    "desc": "<p>这是示例商品的详细描述</p>",
    "sku_list": [
      {
        "sku_id": "789",
        "spec": "红色;XL",
        "price": "99.00",
        "stock": 30
      }
    ],
    "post_fee": "10.00",
    "is_on_sale": 1,
    "create_time": "2023-01-01 10:00:00",
    "update_time": "2023-01-10 15:30:00"
  },
  "status": {
    "status_code": 0,
    "status_reason": "成功"
  }
}

注意事项

调用前需要先获取有效的access_token
商品ID可通过商品列表API获取
频率限制：100次/分钟
敏感字段如价格、库存等可能需要额外权限

如需更详细的信息，请参考微店官方API文档或联系微店开发者支持。