西域平台商品详情接口设计与实现‌

20 阅读2分钟

接口描述:

该接口用于获取西域平台中指定商品的详细信息,包括商品名称、价格、库存、描述、图片等。

图片.png 点击获取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 状态码。 可根据实际需求扩展接口功能,如支持分页、过滤等。

希望这个示例对你有帮助!如果有其他需求,可以随时告诉我哦~