API中心 - 蓝虾仁工具站

邮编查询API文档

调用接口时必须携带API密钥（参数名：api_key），否则将返回401错误！

1. 接口地址

POST https://你的域名/api/api.php

2. 请求参数

参数名	类型	是否必选	描述	示例值
action	String	是	固定值：postcode_query	postcode_query
api_key	String	是	API密钥（从API中心申请，将发送至您的邮箱）	6a8f2d6e3b9c4a7d8e9f0a1b2c3d4e5f
province	String	是	省份名称	广东省
city	String	是	城市名称	深圳市
district	String	否	区/县名称	南山区
street	String	否	街道/乡镇名称	科技园街道

3. 调用示例（JS）

async function queryPostcode() {
  const requestData = new URLSearchParams({
    action: 'postcode_query',
    api_key: '你的API密钥（邮箱接收）',
    province: '广东省',
    city: '深圳市',
    district: '南山区',
    street: '科技园街道'
  });

  const response = await fetch('https://你的域名/api/api.php', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: requestData
  });

  const result = await response.json();
  console.log(result);
  // 成功响应：{code:200, postcode:"518057", adcode:"440305", msg:"查询成功"}
  // 失败响应：{code:403, msg:"API密钥已过期"}
}

4. 响应码说明

状态码	描述	解决方案
200	查询成功	正常获取邮编信息
400	参数不完整	检查省份、城市是否填写
401	未提供API密钥	在请求中添加api_key参数（从邮箱获取）
403	密钥无效/禁用/过期	在「密钥管理」面板刷新密钥
404	未查询到邮编	调整地址关键词（如省略街道）
500	服务器异常	稍后重试，或联系管理员

API中心 - 蓝虾仁工具站

申请API密钥

我的API密钥

邮编查询API文档

1. 接口地址

2. 请求参数

3. 调用示例（JS）

4. 响应码说明