商品免审更新接口

商品免审更新接口。正常情况下，修改商品的基础字段等信息都是需要审核的，通过免审更新接口，商家可以直接修改商品及其SKU的售卖状态、库存信息、价格等信息。免审更新是基于线上版商品数据进行操作的（如果最新版商品处于审核中，会基于免审更新的数据同步更新到最新版商品中）

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/item/direct/modify' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "item_id":"11111", "out_item_id":"12345", "sale_price":30, "original_price":60, "stock_num":100, "sale_status":"AVAILABLE", "skus":[ { "sku_id":"99999", "out_sku_id":"99999", "sale_status":"AVAILABLE", "sale_price":30, "original_price":120, "stock_num":9999 } ] }'

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。该字段特殊可选，与out_item_id不能同时为空，优先使用item_id。【示例值】11111

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一。该字段特殊可选，与item_id不能同时为空，优先使用item_id。【示例值】12345

sale_price

integer

必需

【描述】商品售价，分为单位。若填写了skus[]数组，此字段不填写。若未填写skus[]数组，此字段必填。【示例值】30

original_price

integer

必需

【描述】商品原价，分为单位。若填写了skus[]数组，此字段不填写。【示例值】60

stock_num

integer

可选

【描述】库存若填写了skus[]数组，此字段不填写。若未填写skus[]数组，此字段选填。目前支持库存区间0~99999 【示例值】100

sale_status

string

可选

【描述】商品的售卖状态状态，包含以下两种状态已下架(DELISTING) 可售卖(AVAILABLE) 若填写了skus[]数组，此字段不填写。若未填写skus[]数组，此字段必填。【枚举值】可售卖: AVAILABLE 已下架: DELISTING 【示例值】AVAILABLE

skus

array [object {6}]

可选

【描述】sku数组

sku_id

string

可选

out_sku_id

string

可选

sale_status

string

可选

sale_price

integer

可选

original_price

integer

可选

stock_num

integer

可选

示例

返回响应

🟢200成功

application/json

Body

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一。【示例值】12345

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】2023010122000000000001

skus

array [object {2}]

可选

【描述】sku数组

sku_id

string

可选

out_sku_id

string

可选

🟠400请求有误