小红书 API

批量获取发货时间规则

POST

/ark/open_api/v3/common_controller

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "getDeliveryRuleRequests": [
        {
            "whcode": "601a****fb4b",
            "logisticsPlanId": "601a****fb4b",
            "categoryId": "601a****fb4b"
        }
    ]
}'

响应示例

{
    "deliveryRuleList": [
        {
            "sellerId": "601a****fb4b",
            "planInfoId": "601a****fb4b",
            "whcode": "601a****fb4b",
            "categoryId": "601a****fb4b",
            "logisticsMode": "",
            "existing": [
                {
                    "timeType": "",
                    "value": "",
                    "min": "",
                    "max": "",
                    "desc": "601a****fb4b",
                    "isDefault": "",
                    "default": ""
                }
            ],
            "presale": [
                {
                    "timeType": "",
                    "value": "",
                    "min": "",
                    "max": "",
                    "desc": "601a****fb4b",
                    "isDefault": "",
                    "default": ""
                }
            ],
            "comment": "601a****fb4b",
            "mustFreeReturn": true,
            "supportPreSale": true,
            "notSupportPreSaleCode": ""
        }
    ]
}

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

getDeliveryRuleRequests

array [object {3}]

批量查询

必需

whcode

string

仓库号，自营使用

可选

logisticsPlanId

string

物流方案id

必需

categoryId

string

类目id

必需

示例

返回响应

🟢200成功

application/json

Body

deliveryRuleList

array [object {11}]

批量查询结果

必需

sellerId

string

商家id

可选

planInfoId

string

物流方案id

可选

whcode

string

仓库号，自营使用

可选

categoryId

string

类目id

可选

logisticsMode

string

可选

//1:内贸，2:保税，3:直邮

existing

array [object {7}]

可选

//现货规则，分为当日发，和指定value的几个枚举

presale

array [object {7}]

可选

//预售（最多只有两条规则，相对/绝对）

comment

string

可选

//备注，如果无法返回配置数据的原因

mustFreeReturn

boolean

可选

//是否必须支持7天无理由

supportPreSale

boolean

可选

//是否支持预售（可用预售规则）

notSupportPreSaleCode

integer

可选

//不支持预售原因，1:发货时间格式不正确或不符合规则 2：该类目不支持，3：店铺分过低不支持预售

小红书服务市场保证金要求

获取地址信息（新）