接口描述:
该接口用于获取西域平台中指定商品的详细信息,包括商品名称、价格、库存、描述、图片等。
点击获取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: ['example.com/image1.jpg', '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": [ "example.com/image1.jpg", "example.com/image2.jpg" ], "createdAt": "2025-03-01T10:00:00Z", "updatedAt": "2025-03-28T15:30:00Z" }
注意事项: 确保 productId 参数正确传递,否则会返回错误信息。 接口应做好异常处理,如商品不存在时返回 404 状态码。 可根据实际需求扩展接口功能,如支持分页、过滤等。
希望这个示例对你有帮助!如果有其他需求,可以随时告诉我哦~