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

接口概述

通过商品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": [ "example.com/image1.jpg", "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 = "api.xiyue.com/api/v1/prod…" 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('api.xiyue.com/api/v1/prod…', { 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); } }

// 使用示例 fetchProductDetail('XY123456', 'your_api_key_here');

注意事项 必须启用HTTPS加密传输 API Key需通过请求头传递（非URL参数） 频率限制：100次/分钟 建议缓存商品基础数据，避免高频调用 接口调试建议

使用Postman测试时建议配置：

text Copy Code Headers:

• apiKey: [您的实际密钥] Params:
• itemId: XY123456

通过该接口可快速集成商品数据展示到ERP、商城等系统，建议配合商品列表接口实现完整商品体系对接。