LOGO

全国行政区划查询

提供全国行政区划查询,包括省、市、区县、乡镇四级行政区域数据,助力各类应用快速集成行政区划信息

温馨提示:免费使用(按会员等级进行每天请求次数限制)

套餐

普通会员

100次/天

VIP会员

月:5000次/天

高级VIP

月:11000次/天

钻石VIP

月:14000次/天

立即申请
API介绍
对接文档
示例代码
接口测试
功能介绍
多层级数据覆盖
提供省 - 市 - 区县 - 乡镇 多级行政区划信息查询
极速响应
毫秒级数据响应速度
服务稳定
7X24小时数据稳定响应服务
准确率
>99%
响应速度
约20ms
计费方式
免费,按会员等级限制
应用场景
物流系统地址校验
自动匹配收件地址的行政区划代码,辅助分拣路由规划,降低地址错误导致的配送延误
政务系统信息录入
注册环节通过行政区划 API 快速关联省市区编码,提升户籍、社保等政务数据录入效率
电商区域化运营
根据用户收货地址的行政区划推送本地优惠活动,如区域限定折扣、同城极速达服务
企业客户管理系统
按行政区划归类客户分布,生成区域销售热力图,助力市场策略制定与资源调配
使用流程
注册、登录
注册并登录您的账号
立即注册
完成实名认证
进行个人或企业认证
申请和调试API
申请API和完成测试调试请求
购买和上线使用
购买会员(VIP会员有更多请求次数权益),正式在您的系统上线使用
会员服务
服务保障
稳定高效
提供高可用、低延迟的服务,实施严格的安全措施,确保业务的稳定运行和数据安全
服务完善
专业团队提供全方位的售前和售后服务,随时解决您的疑问和问题
合规安全
严格遵守数据保护法规,官方直连获取数据,确保数据的合法、合规。
持续更新
提供多样接口,并持续更新,以满足您不断变化的业务和商业需求。
全国行政区划查询
请求路径
POST
接口说明
提供全国行政区划查询,包括省、市、区县、乡镇四级行政区域数据,助力各类应用快速集成行政区划信息
请求信息
请求头
Content-Type
application/x-www-form-urlencoded
Auth_Token
签名结果,具体请查看签名规则
Sign_Type
签名结果,具体请查看签名规则
请求参数说明
响应参数
响应参数说明
响应示例
成功响应
{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "createTime": "2025-06-23 10:19:49",
    "data": [
      {
        "id": 110000,
        "level": 1,
        "name": "北京市",
        "parentId": 0
      },
      {
        "id": 120000,
        "level": 1,
        "name": "天津市",
        "parentId": 0
      },
      {
        "id": 130000,
        "level": 1,
        "name": "河北省",
        "parentId": 0
      },
      {
        "id": 140000,
        "level": 1,
        "name": "山西省",
        "parentId": 0
      },
      {
        "id": 150000,
        "level": 1,
        "name": "内蒙古自治区",
        "parentId": 0
      },
      {
        "id": 210000,
        "level": 1,
        "name": "辽宁省",
        "parentId": 0
      },
      {
        "id": 220000,
        "level": 1,
        "name": "吉林省",
        "parentId": 0
      },
      {
        "id": 230000,
        "level": 1,
        "name": "黑龙江省",
        "parentId": 0
      },
      {
        "id": 310000,
        "level": 1,
        "name": "上海市",
        "parentId": 0
      },
      {
        "id": 320000,
        "level": 1,
        "name": "江苏省",
        "parentId": 0
      },
      {
        "id": 330000,
        "level": 1,
        "name": "浙江省",
        "parentId": 0
      },
      {
        "id": 340000,
        "level": 1,
        "name": "安徽省",
        "parentId": 0
      },
      {
        "id": 350000,
        "level": 1,
        "name": "福建省",
        "parentId": 0
      },
      {
        "id": 360000,
        "level": 1,
        "name": "江西省",
        "parentId": 0
      },
      {
        "id": 370000,
        "level": 1,
        "name": "山东省",
        "parentId": 0
      },
      {
        "id": 410000,
        "level": 1,
        "name": "河南省",
        "parentId": 0
      },
      {
        "id": 420000,
        "level": 1,
        "name": "湖北省",
        "parentId": 0
      },
      {
        "id": 430000,
        "level": 1,
        "name": "湖南省",
        "parentId": 0
      },
      {
        "id": 440000,
        "level": 1,
        "name": "广东省",
        "parentId": 0
      },
      {
        "id": 450000,
        "level": 1,
        "name": "广西壮族自治区",
        "parentId": 0
      },
      {
        "id": 460000,
        "level": 1,
        "name": "海南省",
        "parentId": 0
      },
      {
        "id": 500000,
        "level": 1,
        "name": "重庆市",
        "parentId": 0
      },
      {
        "id": 510000,
        "level": 1,
        "name": "四川省",
        "parentId": 0
      },
      {
        "id": 520000,
        "level": 1,
        "name": "贵州省",
        "parentId": 0
      },
      {
        "id": 530000,
        "level": 1,
        "name": "云南省",
        "parentId": 0
      },
      {
        "id": 540000,
        "level": 1,
        "name": "西藏自治区",
        "parentId": 0
      },
      {
        "id": 610000,
        "level": 1,
        "name": "陕西省",
        "parentId": 0
      },
      {
        "id": 620000,
        "level": 1,
        "name": "甘肃省",
        "parentId": 0
      },
      {
        "id": 630000,
        "level": 1,
        "name": "青海省",
        "parentId": 0
      },
      {
        "id": 640000,
        "level": 1,
        "name": "宁夏回族自治区",
        "parentId": 0
      },
      {
        "id": 650000,
        "level": 1,
        "name": "新疆维吾尔自治区",
        "parentId": 0
      },
      {
        "id": 710000,
        "level": 1,
        "name": "台湾省",
        "parentId": 0
      },
      {
        "id": 810000,
        "level": 1,
        "name": "香港",
        "parentId": 0
      },
      {
        "id": 820000,
        "level": 1,
        "name": "澳门",
        "parentId": 0
      },
      {
        "id": 990000,
        "level": 1,
        "name": "苏鲁交界",
        "parentId": 0
      }
    ],
    "orderId": "20250623101948767",
    "orderNumber": "512025062380000000798561"
  }
}
失败响应
{
    "code": 400,
    "msg": "业务处理失败,请稍侯重试",
    "result": null
}
签名规则
所有的主动请求的接口都需要在请求头中传入签名值,需要设置的2个请求头名称:Auth_Token和Sign_Type。下面是分别介绍2个请求头的数据签名规则。 公共参数如下:
第一步:将以上公共参数按以下顺序拼接,并md5加密后小写后传入到signMd5中。 "memberId={memberId}dateTime={dateTime}version={v1}key={appKey}"
第二步:将公共参数按json格式数据设置到请求头Auth_Token中。 例如: Auth_Token={"signMd5":"11c636b1e98c1949768b0117a437145d","version":"v1","dateTime":"1744613181613","memberId":"80000001"}
第三步:并且在请求头中设置签名方式,名称为:Sign_Type。目前系统支持的签名方式有:md5。 例如:Sign_Type=md5
响应码
响应码说明
全国行政区划查询
Java
PHP
Python
C#
复制代码
package com.example.api.V106;

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

import static org.junit.jupiter.api.Assertions.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.util.*;
import java.util.stream.Collectors;
import java.util.Base64;

public class ApiTest1058 {

    // 签名相关的常量
    private static final String SIGN_KEY = "XXXXXX"; // 替换为实际的签名密钥
    private static final String USER_ID = "XXXXXXX"; // 替换为实际的用户编号

    public static void main(String[] args) throws Exception {
        String apiUrl = "https://api.slsj.com/api/ref/regions-cn";
        String orderId = "1058001";
        String parentId = "0";

        // 准备请求参数
        Map<String, Object> params = new HashMap<>();
        params.put("orderId", orderId);
        params.put("parentId", parentId);

        testVerification(apiUrl, params);
    }

    // 获取Auth_Token的方法
    private static String getAuthToken() throws Exception {
        // 获取当前时间戳
        long timestamp = System.currentTimeMillis();

        // 按照文档拼接待加密字符串
        String toEncrypt = "memberId=" + USER_ID + "dateTime=" + timestamp + "version=v1" + "key=" + SIGN_KEY;

        // MD5加密
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] digest = md.digest(toEncrypt.getBytes(StandardCharsets.UTF_8));
        String md5Result = bytesToHex(digest).toLowerCase();

        // 创建鉴权Token的JSON对象
        JSONObject authTokenObj = new JSONObject();
        authTokenObj.set("memberId", USER_ID);
        authTokenObj.set("dateTime", timestamp);
        authTokenObj.set("version", "v1");
        authTokenObj.set("signMd5", md5Result);
        
        String authToken = authTokenObj.toString();
        return authToken;
    }

    // 辅助方法:将字节数组转换为十六进制字符串
    private static String bytesToHex(byte[] bytes) {
        StringBuilder result = new StringBuilder();
        for (byte b : bytes) {
            result.append(String.format("%02x", b));
        }
        return result.toString();
    }

    public static void testVerification(String apiUrl,Map<String, Object> params) throws Exception {
        
        // 获取鉴权Token
        String authToken = getAuthToken();
        
        // 发送请求
        HttpResponse response = HttpRequest.post(apiUrl)
            .header("Content-Type", "application/x-www-form-urlencoded")
            .header("Auth_Token", authToken)
            .header("Sign_Type", "md5")
            .form(params)
            .execute();
        
        // 输出响应结果
        int status = response.getStatus();
        String responseBody = response.body();
        
        System.out.println("响应状态码: " + status);
        System.out.println("响应内容: " + responseBody);
        
        // 验证响应码
        assertEquals(HttpURLConnection.HTTP_OK, status, "Response code should be 200");
        
        // 解析响应内容(假设响应是JSON格式)
        // JSONObject responseJson = JSONUtil.parseObj(responseBody);
    }
} 
复制代码
代码信息正在添加中...
复制代码
import hashlib
import json
import time
import requests

# 用户ID和密钥
user_id = "xxxxxx"  # 替换为实际的用户编号
signature_key = "xxxxxxxxxxxxxxx"   # 替换为实际的签名密钥

# 版本号
version = "v1"


# 生成加密签名
def generate_auth_token():
    query_time = int(time.time() * 1000)
    original_string = f'memberId={user_id}dateTime={query_time}version={version}key={signature_key}'
    md5_result = hashlib.md5(original_string.encode('utf-8')).hexdigest()
    auth_token = {
        "memberId": user_id,
        "dateTime": query_time,
        "version": version,
        "signMd5": md5_result

    }
    return auth_token


# 请求接口并打印响应结果
request_url = 'https://api.slsj.com/api/ref/regions-cn'
params = {
    "orderId": "20250416094659001",
    "parentId": None

}
headers = {'Content-Type': 'application/x-www-form-urlencoded', 'Auth_Token': json.dumps(generate_auth_token()),
           'Sign_Type': 'md5'}
response = requests.post(headers=headers, url=request_url, data=params)
if response.status_code == 200:
    print(response.json())
else:
    print(response.text)
复制代码
代码信息正在添加中...
APILOGO

全国行政区划查询

ID:654

申请次数

17

收藏次数

24

认证要求

个人
企业

场景审核

不需要

联系方式

联系电话:

400-000-6665

联系邮箱:

suilian@suiliantech.com

在线客服: