通过该接口可以获取微店平台指定商品的详细信息,包括商品标题、价格、库存、描述、图片等。
请求URL
https://api.weidian.com/v1/products/{product_id}
请求方法
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": "https://example.com/image1.jpg",
"is_main": true
},
{
"image_url": "https://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标准格式。
示例请求
bash
Copy Code
curl -X GET "https://api.weidian.com/v1/products/12345" \
-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": "https://example.com/yurongfu1.jpg",
"is_main": true
},
{
"image_url": "https://example.com/yurongfu2.jpg",
"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:服务器内部错误。
通过以上接口,开发者可以方便地获取微店平台上商品的详细信息,以便进行后续的处理和展示。