如何获取淘宝/天猫购物车的商品列表 API 返回值说明

buyer_cart_list-获取购物车的商品列表

taobao.buyer_cart_list

公共参数

请求地址: https://api-gw-4.cn/taobao/buyer_cart_list

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：page=

参数说明：page:页码
token:SaaS授权

响应参数

Version: Date:

名称	类型	必须	示例值	描述
cart_id	Bigint	0	1055921809617	购物车商品ID
num_iid	Bigint	0	544135010416	商品ID
title	String	0	Philips/飞利浦 DLK35002 车载手机支架 多功能吸盘式汽车手机座	商品标题
pic_url	String	0	//img.alicdn.com/bao/uploaded/i2/2934435917/TB2Ite9tlsmBKNjSZFFXXcT9VXa_!!2934435917-0-item_pic.jpg	宝贝图片
detail_url	String	0	//detail.tmall.com/item.htm?id=544135010416	宝贝链接
promotion_price	Int	0	69	优惠价
price	Int	0	99	价格
num	Int	0	1	数量
sku	Mix	0	{"颜色分类": "黑色"}	商品规格列表
is_tmall	Boolean	0	true	是否天猫
seller_info	Mix	0	{"shop_type": "B", "title": "飞利浦淘参谋专卖", "sid": 165655803, "user_num_id": "2934435917", "zhuy": "//store.taobao.com/shop/view_shop.htm?user_number_id=2934435917"}	卖家信息

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/taobao/buyer_cart_list/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&page="

响应示例

异常示例

相关资料

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否

API 工具

淘宝/天猫的购物车API返回值会包含当前用户购物车中的商品列表及相关信息。以下是API返回值可能包含的主要字段和信息的详细说明：

1. **购物车商品ID**：每个商品在购物车中的唯一标识符。

2. **商品ID**：与商品在淘宝/天猫平台上的唯一标识符相对应。

3. **商品标题**：商品的名称或标题。

4. **商品图片**：商品的展示图片，可能有不同尺寸。

5. **商品数量**：购物车中该商品的数量。

6. **商品规格**：用户选择的商品规格，如颜色、尺码等。

7. **商品价格**：商品的单价，可能包含原价和折扣价。

8. **商品总价**：商品数量乘以商品单价的总额，反映购物车中该商品的总价。

9. **商品链接**：商品的详情页面链接。

10. **是否选中**：标记购物车中商品是否被选中，如果为“是”，则代表该商品会被包括在结算过程中。

11. **店铺信息**：商品所属店铺的名称、店铺ID等信息。

12. **库存状态**：商品当前的库存状态，如“有货”、“缺货”等。

13. **优惠信息**：购物车商品可能享有的优惠，如满减、优惠券等。

14. **商品属性**：商品的其他属性，如品牌、生产地、适用人群等。

15. **是否预售**：如果商品为预售商品，此字段会标记为“是”。

16. **发货时间**：商品的预计发货时间。

17. **错误码和错误信息**：如果请求失败，会返回错误码和对应的错误信息，帮助开发者定位问题。

请注意，具体的返回值和字段可能会根据API的版本、调用方式以及淘宝/天猫平台的更新而有所变化。在实际开发过程中，强烈建议参考淘宝/天猫的官方API文档，以获取最准确、最新的信息。

同时，使用这些API时，确保你的应用符合淘宝/天猫的开发规则和政策，并且用户已经完成了必要的授权流程。