微店商品详情接口开发指南
接口概述
微店商品详情接口(/api/v1/product/detail)用于获取商品的完整信息,包括标题、价格、库存、SKU、主图等数据,支持OAuth2.0鉴权。
点击获取key和secret
请求方式
GET https://open.weidian.com/api/v1/product/detail
请求参数
参数名类型必填说明pidstring是商品IDaccess_tokenstring是授权令牌
响应示例(JSON)
{
"code": 0,
"data": {
"pid": "123456",
"title": "夏季新款T恤",
"price": 99.00,
"stock": 100,
"images": ["https://img.url/1.jpg"],
"skus": [
{"id": "s1", "spec": "黑色/L", "price": 99.00}
]
}
}
错误码
4001: 参数缺失
4003: 商品不存在
代码示例(Python)
import requests
def get_product_detail(pid, token):
url = "https://open.weidian.com/api/v1/product/detail"
params = {"pid": pid, "access_token": token}
response = requests.get(url, params=params)
if response.json().get("code") == 0:
return response.json()["data"]
else:
raise Exception("接口请求失败")
注意事项
需提前申请开发者权限并获取access_token
高频调用需遵守接口限流规则(100次/分钟)