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

西域平台商品详情接口开发指南（含代码示例）

news 来源：原创 2025/6/18 21:56:15

接口概述

通过商品ID获取商品详细信息（标题、价格、库存等），采用RESTful风格设计，支持HTTP GET请求，返回JSON格式数据。

点击获取key和secret

接口功能
获取商品基础信息
返回实时库存状态
支持多规格商品数据查询
请求方式
http
Copy Code
GET /api/v1/product/detail

请求参数
参数名   类型   必填   说明
itemId   string   是   商品唯一标识（如：XY123456）
apiKey   string   是   授权密钥（Header中传递）
成功响应示例
json
Copy Code
{
"code": 200,
"data": {
    "itemId": "XY123456",
    "title": "工业级电动扳手 XYZ-3000",
    "price": 499.00,
    "stock": 150,
    "specs": [
      {"name": "功率", "value": "650W"},
      {"name": "扭矩", "value": "380N.m"}
    ],
    "description": "适用于重型机械维护...",
    "images": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg"
    ]
}
}

错误响应示例
json
Copy Code
{
"code": 404,
"message": "商品不存在"
}

代码实现示例
Python（使用requests库）
python
Copy Code
import requests

def get_product_detail(item_id, api_key):
    url = "https://api.xiyue.com/api/v1/product/detail"
    headers = {"apiKey": api_key}
    params = {"itemId": item_id}

    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.HTTPError as err:
        print(f"HTTP错误: {err}")
    except Exception as e:
        print(f"请求异常: {e}")

# 使用示例
product_data = get_product_detail("XY123456", "your_api_key_here")
if product_data and product_data["code"] == 200:
print(f"商品标题：{product_data['data']['title']}")
print(f"当前库存：{product_data['data']['stock']}")

JavaScript（使用axios）
javascript
Copy Code
const axios = require('axios');

async function fetchProductDetail(itemId, apiKey) {
try {
    const response = await axios.get('https://api.xiyue.com/api/v1/product/detail', {
      headers: { apiKey },
      params: { itemId }
    });

    if (response.data.code === 200) {
      console.log(`商品标题：${response.data.data.title}`);
      console.log(`当前价格：￥${response.data.data.price}`);
    }
    return response.data;
} catch (error) {
    console.error('请求失败:', error.response?.data || error.message);
}
}