接口描述:
该接口用于获取西域平台中指定商品的详细信息,包括商品名称、价格、库存、描述、图片等。
点击获取key和secret
接口地址:
GET /api/product/detail
请求参数:
参数名 类型 是否必填 描述
productId string 是 商品唯一标识ID
响应参数:
参数名 类型 描述
productId string 商品唯一标识ID
productName string 商品名称
price number 商品价格
stock number 商品库存
description string 商品描述
images array 商品图片列表
createdAt string 商品创建时间
updatedAt string 商品更新时间
示例代码(Node.js + Express):
javascript
Copy Code
const express = require('express');
const app = express();
const PORT = 3000;
// 模拟商品数据
const products = [
{
productId: '12345',
productName: '西域特色干果礼盒',
price: 99.99,
stock: 100,
description: '精选西域优质干果,健康美味,送礼佳品。',
images: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg'],
createdAt: '2025-03-01T10:00:00Z',
updatedAt: '2025-03-28T15:30:00Z'
}
];
// 商品详情接口
app.get('/api/product/detail', (req, res) => {
const { productId } = req.query;
if (!productId) {
return res.status(400).json({ error: 'productId is required' });
}
const product = products.find(p => p.productId === productId);
if (!product) {
return res.status(404).json({ error: 'Product not found' });
}
res.json(product);
});
// 启动服务
app.listen(PORT, () => {
console.log(`Server is running on http://localhost:${PORT}`);
});
请求示例:
text
Copy Code
GET /api/product/detail?productId=12345
响应示例:
json
Copy Code
{
"productId": "12345",
"productName": "西域特色干果礼盒",
"price": 99.99,
"stock": 100,
"description": "精选西域优质干果,健康美味,送礼佳品。",
"images": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"createdAt": "2025-03-01T10:00:00Z",
"updatedAt": "2025-03-28T15:30:00Z"
}
注意事项:
确保 productId 参数正确传递,否则会返回错误信息。
接口应做好异常处理,如商品不存在时返回 404 状态码。
可根据实际需求扩展接口功能,如支持分页、过滤等。
希望这个示例对你有帮助!如果有其他需求,可以随时告诉我哦~