Add Cart Item

POST

/v2/taobao/cart/add

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

userId

string

平台userId

可选

platform

integer

可选

商品来源 0：淘宝 1：:1688

itemMapId

string

商品ID

必需

skuId

string

skuId

必需

itemTitle

string

商品标题

必需

itemPic

string

商品图片

必需

mpId

string

必需

mpSkuId

string

必需

price

integer

商品价格

必需

promotionPrice

integer

商品优惠后价格

可选

properties

string

sku属性

可选

quantity

integer

数量

必需

shopId

integer

店铺ID

必需

aliShopId

string

店铺ID

可选

shopName

string

店铺名称

必需

skuQuantity

string

sku对应的库存

必需

userNick

string

userNick

可选

priceRanges

array[object (PriceRange) {2}]

价格区间

可选

startQuantity

integer | null

起批量

可选

price

number | null

批发价

可选

quoteType

integer

可选

普通报价-FIXED_PRICE("0"),SKU规格报价-SKU_PRICE("1"),SKU区间报价（商品维度）-SKU_PRICE_RANGE_FOR_OFFER("2")

示例

{
  "itemMapId": "WUnUC1cILiBjt-Jv3lDdlQ",
  "skuId": "5032007803360",
  "itemTitle": "2025新款休闲短袖衬衫男士夏季薄款韩版潮流半袖衬衣帅气寸衫上衣",
  "itemPic": "https://img.alicdn.com/bao/uploaded/i1/2202282511/O1CN01f70KIV1UQ5HNQRt17_!!2202282511.jpg",
  "mpId": "NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0",
  "mpSkuId": "7579055774996",
  "price": 13900,
  "promotionPrice": 3990,
  "quantity": 1,
  "shopId": 115037976,
  "shopName": "小淘男装服饰",
  "skuQuantity": "100001"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/taobao/cart/add' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemMapId":"WUnUC1cILiBjt-Jv3lDdlQ",
    "skuId":"5032007803360",
    "itemTitle":"2025新款休闲短袖衬衫男士夏季薄款韩版潮流半袖衬衣帅气寸衫上衣",
    "itemPic":"https://img.alicdn.com/bao/uploaded/i1/2202282511/O1CN01f70KIV1UQ5HNQRt17_!!2202282511.jpg",
    "mpId":"NeZYO6vIHuENAqbW6iWQb7dqmzNNcIX-IQGrQ53mhv0",
    "mpSkuId":"7579055774996",
    "price":13900,
    "promotionPrice":3990,
    "quantity":1,
    "shopId":115037976,
    "shopName":"小淘男装服饰",
    "skuQuantity":"100001"

}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

boolean

返回内容

可选

示例

{
  "requestId": "2a285e601e5c4a2a84ba244a87e09dba",
  "code": 200,
  "developId": "1110890638347337996",
  "msg": "成功",
  "data": true
}

修改于 2025-04-25 03:58:01

Delete Cart Item

Edit item quantity