淘宝店铺所有商品API的JSON数据返回通常包含商品的基本信息、动态数据以及分页信息等。以下是一个详细的JSON数据返回示例,以及相关字段的说明:
JSON数据返回示例
json { "items": { "item": [ { "num_iid": 112233445566, "title": "夏季新款纯棉T恤", "price": "59.90", "stock": 100, "image_url": "https://img01.taobao.com/xxx.jpg", "detail_url": "https://item.taobao.com/item.htm?id=112233445566", "category_id": 123456, "category_name": "男装/T恤", "created": "2023-01-01 12:00:00", "modified": "2023-01-10 15:30:00", "status": "onsale", "sales": 500, "promotion_info": { "has_promotion": true, "promotion_type": "discount", "promotion_price": "49.90", "promotion_start": "2023-01-15 00:00:00", "promotion_end": "2023-01-20 23:59:59" } }, { "num_iid": 223344556677, "title": "休闲牛仔裤", "price": "89.00", "stock": 50, "image_url": "https://img02.taobao.com/yyy.jpg", "detail_url": "https://item.taobao.com/item.htm?id=223344556677", "category_id": 789012, "category_name": "男装/牛仔裤", "created": "2023-02-01 09:00:00", "modified": "2023-02-05 14:20:00", "status": "onsale", "sales": 300, "promotion_info": { "has_promotion": false } } ] }, "total_results": 200, "page_no": 1, "page_size": 50, "request_id": "abc123xyz456" }
字段说明
- items:包含商品列表的对象。
- item:商品数组,每个元素代表一个商品。
- num_iid:商品ID,唯一标识。
- title:商品标题。
- price:商品价格。
- stock:商品库存量。
- image_url:商品主图URL。
- detail_url:商品详情页URL。
- category_id:商品所属分类ID。
- category_name:商品所属分类名称。
- created:商品创建时间。
- modified:商品最后修改时间。
- status:商品状态(如onsale表示在售)。
- sales:商品销量。
- promotion_info:商品促销信息。
- has_promotion:是否有促销活动。
- promotion_type:促销类型(如discount表示折扣)。
- promotion_price:促销价格。
- promotion_start:促销开始时间。
- promotion_end:促销结束时间。
- total_results:总商品数量。
- page_no:当前页码。
- page_size:每页商品数量。
- request_id:请求ID,用于唯一标识一次请求。
注意事项
- 字段可选性:并非所有字段都会在每次请求中返回,具体取决于API接口的配置和请求参数。
- 分页处理:如果店铺商品数量较多,API通常会支持分页返回,通过
page_no
和page_size
参数控制。 - 错误处理:如果请求失败,API可能会返回错误码和错误信息,如
{"error_response":{"code":1001,"msg":"参数错误"}}
。 - 数据更新:返回的数据可能不是实时的,具体取决于API的更新频率和缓存策略。
调用示例(伪代码)
python import requests import json url = "https://eco.taobao.com/router/rest" params = { "app_key": "your_app_key", "method": "taobao.shop.items.get", "timestamp": "2023-01-01 12:00:00", "format": "json", "v": "2.0", "shop_id": "12345678", "page_no": 1, "page_size": 50, "fields": "num_iid,title,price,stock,image_url,detail_url,category_id,category_name,created,modified,status,sales,promotion_info" } params["sign"] = "your_sign_here" # 根据淘宝开放平台规则生成签名 response = requests.get(url, params=params) data = response.json() print(json.dumps(data, indent=4, ensure_ascii=False))
以上是一个详细的淘宝店铺所有商品API的JSON数据返回示例及说明,希望对你有所帮助。