淘宝店铺所有商品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数据返回示例及说明，希望对你有所帮助。
