LOGO

全国邮编区号查询

提供全国邮编区号查询,覆盖 34 个省级行政区、300 + 地级市数据,支持地址与编码双向检索,助力物流、政务等系统高效集成区域编码信息

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

套餐

普通会员

100次/天

VIP会员

月:5000次/天

高级VIP

月:11000次/天

钻石VIP

月:14000次/天

立即申请
API介绍
对接文档
示例代码
接口测试
功能介绍
全地域覆盖
提供全国从省份级别到区县级别邮编和区号数据信息
支持多条件检索
支持通过省市名称、行政编号、邮政编码等方式进行查询
极速响应
毫秒级数据响应速度
服务稳定
7X24小时数据稳定响应服务
准确率
>99%
响应速度
约30ms
更新频率
月更新
计费方式
免费,按会员等级限制
应用场景
物流系统自动分拣
根据收货地址匹配邮编区号,智能规划最优配送路线,提升包裹分拣效率
电商订单管理
下单时自动填充邮编区号,减少用户输入错误,降低因地址问题导致的退换货率
政务服务平台
在户籍、社保等业务办理中快速关联属地邮编区号,优化办事流程,提升用户体验
企业 CRM 系统
按邮编区号分析客户地域分布,辅助市场策略制定,精准定位区域销售机会
使用流程
注册、登录
注册并登录您的账号
立即注册
完成实名认证
进行个人或企业认证
申请和调试API
申请API和完成测试调试请求
购买和上线使用
购买会员(VIP会员有更多请求次数权益),正式在您的系统上线使用
会员服务
服务保障
稳定高效
提供高可用、低延迟的服务,实施严格的安全措施,确保业务的稳定运行和数据安全
服务完善
专业团队提供全方位的售前和售后服务,随时解决您的疑问和问题
合规安全
严格遵守数据保护法规,官方直连获取数据,确保数据的合法、合规。
持续更新
提供多样接口,并持续更新,以满足您不断变化的业务和商业需求。
全国邮编区号查询
请求路径
POST
接口说明
提供全国邮编区号查询,覆盖 34 个省级行政区、300 + 地级市数据,支持地址与编码双向检索,助力物流、政务等系统高效集成区域编码信息
请求信息
请求头
Content-Type
application/x-www-form-urlencoded
Auth_Token
签名结果,具体请查看签名规则
Sign_Type
签名结果,具体请查看签名规则
请求参数说明
响应参数
响应参数说明
响应示例
成功响应
{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "createTime": "2025-06-20 16:04:13",
    "data": [
      {
        "area": "天河区",
        "areaCode": 20,
        "city": "广州市",
        "postCode": 510600,
        "province": "广东省"
      }
    ],
    "orderId": "20250620160412469",
    "orderNumber": "512025062080000000228622"
  }
}
失败响应
{
    "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 ApiTest1062 {

    // 签名相关的常量
    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/postal-area-code-cn";
        String orderId = "1062001";
        //String area = "";
        //String areaCode = "";
        String province = "广东省";
        String city = "广州市";
        //String postCode = "";
        
        // 准备请求参数
        Map<String, Object> params = new HashMap<>();
        params.put("orderId", orderId);
        //params.put("area", area);
        //params.put("areaCode", areaCode);
        params.put("province", province);
        params.put("city", city);
        //params.put("postCode", postCode);

        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/postal-area-code-cn'
params = {
    "orderId": "20250416094659001",
    "area": "天河区",
    "areaCode": "20",
    "city": "广州市",
    "postCode": "510600",
    "province": "广东省"

}
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:658

申请次数

27

收藏次数

26

认证要求

个人
企业

场景审核

不需要

联系方式

联系电话:

400-000-6665

联系邮箱:

suilian@suiliantech.com

在线客服: