获取商家地址库

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 '{
    "pageIndex": 1,
    "pageSize": 20
}'

响应示例

{
    "sellerAddressRecordList": [
        {
            "sellerAddressRecordId": 105380,
            "contactName": "张xx",
            "phoneAreaCode": "86",
            "phone": "12312345678",
            "landlineAreaCode": "",
            "landlinePhone": "",
            "landlineExtensionNumber": "",
            "countryCode": "001",
            "provinceCode": "220000",
            "cityCode": "220100",
            "countyCode": "",
            "townCode": "",
            "countryName": "中国大陆",
            "provinceName": "吉林省",
            "cityName": "长春市",
            "countyName": "",
            "townName": "",
            "address": "111",
            "fullAddress": "吉林省 长春市 111",
            "deliveryDefault": "NON_DEFAULT",
            "aftersaleDefault": "NON_DEFAULT",
            "version": 1,
            "active": "ACTIVE",
            "createTime": 1663048640000,
            "updateTime": 1663048640000
        }
    ],
    "total": 50
}

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

pageIndex

integer

可选

默认返回商家收货地址的页数为1，限制小于100

pageSize

integer

可选

默认返回20，限制小于200

示例

返回响应

🟢200成功

application/json

Body

sellerAddressRecordList

array [object {25}]

商家地址列表

必需

sellerAddressRecordId

integer

商家地址id

可选

contactName

string

联系人

可选

phoneAreaCode

string

手机区号

可选

phone

string

手机号

可选

landlineAreaCode

string

座机区号

可选

landlinePhone

string

座机号

可选

landlineExtensionNumber

string

分机号

可选

countryCode

string

国家代码

可选

provinceCode

string

省代码

可选

cityCode

string

市代码

可选

countyCode

string

区/县代码

可选

townCode

string

镇/街道代码

可选

countryName

string

国家名称

可选

provinceName

string

省名称

可选

cityName

string

市名称

可选

countyName

string

区/县名称

可选

townName

string

镇/街道名称

可选

address

string

详细地址

可选

fullAddress

string

完整地址

可选

deliveryDefault

string

可选

是否发货默认 NON_DEFAULT-非默认; DEFAULT-默认

aftersaleDefault

string

可选

是否售后默认 NON_DEFAULT-非默认; DEFAULT-默认

version

integer

版本号

可选

active

string

可选

是否生效 ACTIVE-生效; INACTIVE-无效

createTime

integer

创建时间

可选

updateTime

integer

更新时间

可选

total

integer

返回的商家地址总数

必需

修改于 2023-08-01 02:56:30

获取地址信息（新）

获取分类列表