接口基本信息

• 接口名称: item_get
• 请求方式: HTTP GET/POST
• 内容类型: application/json
• 字符编码: UTF-8

请求参数

必填参数

可选参数

签名生成方法

签名(sign)生成步骤：

1. 将所有请求参数(除sign外)按参数名升序排列
2. 将参数名和值拼接成字符串(key1value1key2value2...)
3. 在字符串首尾加上app_secret
4. 对结果字符串进行MD5加密，得到签名

响应参数

成功响应

json{"code": 200,"msg": "success","data": {"item_id": "12345678","title": "商品标题","price": 99.00,"market_price": 199.00,"brand_id": "1001","brand_name": "品牌名称","category_id": "2001","category_name": "分类名称","images": ["http://img.vip.com/image1.jpg","http://img.vip.com/image2.jpg"],"description": "商品描述","stock": 100,"sales": 50,"is_promotion": true,"promotion_info": {"type": "discount","value": "8折","start_time": "2023-01-01 00:00:00","end_time": "2023-01-07 23:59:59"},"delivery_info": {"area": "全国","fee": 0.00,"time": "48小时内发货"},"sku_list": [{"sku_id": "sku001","specs": "颜色:红色,尺寸:M","price": 99.00,"stock": 30},{"sku_id": "sku002","specs": "颜色:蓝色,尺寸:L","price": 99.00,"stock": 20}]}}

错误响应

json{"code": 400,"msg": "Invalid item_id","data": null}

常见错误码

使用示例

PHP示例

php<?php$app_key = 'your_app_key';$app_secret = 'your_app_secret';$item_id = '12345678';$params = ['method' => 'item_get','app_key' => $app_key,'timestamp' => date('Y-m-d H:i:s'),'item_id' => $item_id];// 生成签名ksort($params);$sign_str = $app_secret;foreach ($params as $key => $value) {$sign_str .= $key . $value;}$sign_str .= $app_secret;$params['sign'] = strtoupper(md5($sign_str));// 发送请求$url = 'https://openapi.vip.com/api?' . http_build_query($params);$response = file_get_contents($url);$result = json_decode($response, true);// 处理结果if ($result['code'] == 200) {$item_info = $result['data'];print_r($item_info);} else {echo "Error: " . $result['msg'];}?>

Python示例

pythonimport hashlibimport timeimport requestsapp_key = 'your_app_key'app_secret = 'your_app_secret'item_id = '12345678'params = {'method': 'item_get','app_key': app_key,'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),'item_id': item_id}# 生成签名sorted_params = sorted(params.items(), key=lambda x: x[0])sign_str = app_secret + ''.join([k + v for k, v in sorted_params]) + app_secretsign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()params['sign'] = sign# 发送请求url = 'https://openapi.vip.com/api'response = requests.get(url, params=params)result = response.json()# 处理结果if result['code'] == 200:item_info = result['data']print(item_info)else:print(f"Error: {result['msg']}")

注意事项

1. 频率限制: 接口有调用频率限制，请遵守唯品会API使用条款
2. 数据缓存: 建议对获取的商品数据进行缓存，避免频繁调用
3. 字段选择: 使用fields参数指定需要的字段可以减少数据传输量
4. 错误处理: 必须实现完善的错误处理机制
5. 签名安全: 妥善保管app_secret，不要泄露

高级功能

1. 批量获取: 某些版本可能支持批量获取多个商品信息，需查看具体文档
2. 增量更新: 通过时间戳参数获取自某时间点后更新的商品信息
3. 多语言支持: 部分接口可能支持多语言返回

如需更详细的信息，建议查阅唯品会官方API文档或联系唯品会开放平台技术支持。