唯品会按关键字搜索 VIP 商品的item_search
API 返回值通常包含以下信息:
- 基本信息:
- 商品 ID:商品在唯品会平台上的唯一标识符。
- 商品标题:商品的名称,是用户搜索和识别商品的重要依据。
- 商品图片 URL:商品的图片链接,一般包含多张图片链接,用于展示商品外观。
- 价格与促销信息:
- 商品价格:可能包括原价、折扣价、现价等信息。
- 原价:商品的原始价格,可用于展示折扣力度。
- 折扣:商品的折扣信息,如 “5 折” 等。
- 现价:商品的当前售价,即用户实际需要支付的价格。
- 库存与物流信息:
- 库存数量:商品的当前库存量,能让用户了解商品的可购买性。
- 其他信息:
- 商品描述:对商品的详细介绍,帮助用户更好地了解商品特点和功能。
- 商品属性:包括商品的规格、型号、材质等属性信息。
- 销售与评价数据:如商品的销量、用户评价等,可帮助用户评估商品的受欢迎程度和质量。
1. 错误码示例
状态码 (code) | 说明 (message) |
---|---|
400 | 参数错误 |
401 | 未授权(如API密钥无效) |
404 | 无匹配商品 |
500 | 服务器内部错误 |
1. 调用示例(CURL)
curl -X GET "https://api.vip.com/search?keyword=连衣裙&page=1&page_size=20&sort=sales" \ -H "Authorization: Bearer YOUR_API_KEY"
返回值的数据格式一般为 JSON。
不过,具体的返回值格式和字段可能会根据唯品会平台的更新而有所变化,使用时建议查阅最新的唯品会开放平台 API 文档以获取最准确的信息。