2.1 省市区列表

POST

/api/v1/region/list

功能说明

获取省市区列表,支持按名称、id、国家行政区划代码进行搜索

应用场景

在计算运费、订单预览、生成的时候，需要传入收货地址的信息

注意事项

可通过基础物料下载，线下做好业务系统与我司地址信息的映射，在使用时，直接传递id即可

请求参数

Header 参数

Body 参数application/json

示例

{
    "name":"北京",
    "id": 132,
    "parentId":0,
    "level":1,
    "cityCode":110000,
    "pagination": {
        "page":1,
        "pageSize": 20
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-openapi.7dingdong.com/api/v1/region/list' \
--header 'appKey;' \
--header 'token;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"北京",
    "id": 132,
    "parentId":0,
    "level":1,
    "cityCode":110000,
    "pagination": {
        "page":1,
        "pageSize": 20
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "status": 200,
    "msg": "请求成功",
    "requestId": "2e480f32-3900-11ef-8d27-08002763b2f5",
    "content": {
        "total": 1,
        "currentPage": 1,
        "perPage": 20,
        "count": 1,
        "items": [
            {
                "id": 132,
                "parentId": 0,
                "name": "北京市",
                "level": 1,
                "cityCode": 110000
            }
        ]
    }
}

修改于 2024-07-03 12:32:34

1.4 设置回调地址

2.2 省市区详情