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时,确保你的应用符合淘宝/天猫的开发规则和政策,并且用户已经完成了必要的授权流程。