当前位置：首页 > news >正文

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

news 来源：原创 2025/5/2 17:39:08

接口描述：

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

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

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