微店商品详情查询接口(含商品全方位信息)

171 阅读2分钟

通过该接口可以获取微店平台指定商品的详细信息,包括商品标题、价格、库存、描述、图片等。

请求URL

api.weidian.com/v1/products…

请求方法

GET

请求参数 product_id(路径参数):商品的唯一标识符,类型为整数。 请求头 Content-Type:application/json Authorization:Bearer {access_token}(需要替换为实际的访问令牌) 响应格式

JSON

响应参数 json Copy Code { "product_id": 12345, "title": "商品标题", "price": 100.00, "original_price": 150.00, "stock": 100, "description": "商品描述信息,包括详细的功能介绍、使用说明等。", "images": [ { "image_url": "example.com/image1.jpg", "is_main": true }, { "image_url": "example.com/image2.jpg", "is_main": false } ], "specifications": [ { "name": "颜色", "values": ["红色", "蓝色", "绿色"] }, { "name": "尺寸", "values": ["S", "M", "L"] } ], "created_at": "2025-01-24T12:00:00Z", "updated_at": "2025-01-24T12:00:00Z" }

响应参数说明 product_id:商品的唯一标识符。 title:商品标题。 price:商品价格,单位为元。 original_price:商品原价,单位为元(如果有折扣的话)。 stock:商品库存数量。 description:商品描述信息。 images:商品图片列表,每个图片对象包含image_url(图片链接)和is_main(是否为主图)两个字段。 specifications:商品规格列表,每个规格对象包含name(规格名称)和values(规格值列表)两个字段。 created_at:商品创建时间,采用ISO 8601标准格式。 updated_at:商品最后更新时间,采用ISO 8601标准格式。

图片.png 点击获取key和secret 示例请求 bash Copy Code curl -X GET "api.weidian.com/v1/products…"
-H "Content-Type: application/json"
-H "Authorization: Bearer your_access_token"

示例响应 json Copy Code { "product_id": 12345, "title": "冬季新款羽绒服", "price": 299.00, "original_price": 399.00, "stock": 50, "description": "这款羽绒服采用优质鸭绒填充,保暖性能极佳,适合寒冷冬季穿着。", "images": [ { "image_url": "example.com/yurongfu1.j…", "is_main": true }, { "image_url": "example.com/yurongfu2.j…", "is_main": false } ], "specifications": [ { "name": "颜色", "values": ["黑色", "白色"] }, { "name": "尺码", "values": ["M", "L", "XL"] } ], "created_at": "2025-01-20T10:00:00Z", "updated_at": "2025-01-22T14:00:00Z" }

错误码 400:请求参数错误,如product_id无效。 401:未授权,访问令牌无效或已过期。 404:指定的商品不存在。 500:服务器内部错误。

通过以上接口,开发者可以方便地获取微店平台上商品的详细信息,以便进行后续的处理和展示。