智慧门牌系统 · 开放接口文档

标准地址核验 / 地址解析 / 数据共享接口 · 供市场监管、住建、教育、水电气等单位对接

POST/api/open/verify 地址核验
请求参数(JSON)
字段类型必填说明
keystring是平台签发的接口密钥
addressstring是待核验的地址文本或标准地址编码
请求示例
curl -X POST http://127.0.0.1:8000/api/open/verify \
  -H "Content-Type: application/json" \
  -d '{"key":"mk_xxxx","address":"渝水区抱石大道12号3栋2单元801室"}'
响应示例
{
  "ok": true,
  "exists": true,
  "score": 1.0,
  "standard": "渝水区抱石大道12号3栋2单元801室",
  "code": "3605020012000120302080 18",
  "street": "抱石大道",
  "purpose": "住宅",
  "community": "北湖社区"
}
GET/api/open/parse 地址模糊解析
查询参数
字段类型必填说明
keystring是接口密钥
qstring是非标准地址描述,如“抱石大道12号”
请求示例
curl "http://127.0.0.1:8000/api/open/parse?key=mk_xxxx&q=抱石大道12号"
GET/api/public/addr/{short} 群众端门牌信息(公开、脱敏)
说明:扫码后由群众端调用,返回标准地址、责任民警、社区、坐标等,不含身份证号等敏感字段。
curl "http://127.0.0.1:8000/api/public/addr/a1b2c3d4"
POST/api/public/report 隐患/纠纷上报
{
  "short": "a1b2c3d4",
  "type": "隐患上报",
  "content": "3栋2单元楼道堆放杂物,影响疏散",
  "reporter": "辖区居民",
  "phone": "13900000000"
}
POST/api/public/alarm 一键报警(带标准地址与坐标)
说明:正式环境由前置服务将地址编码、坐标推送至 110 接处警系统生成警单。
{ "short": "a1b2c3d4", "reporter": "张三", "phone": "13900000000" }
POST/api/police/scan/{short|code} 民警扫码核址(需登录令牌)
返回:房屋档案、实有人口、单位、检查记录、历史工单
curl -H "Authorization: Bearer <token>" \
  http://127.0.0.1:8000/api/police/scan/a1b2c3d4
GET/api/overview 运行指标(管理后台看板)
返回上墙率、鲜活率、扫码趋势、分色结构、待办数量等统计指标。
GET/qr/{short}.png 门牌二维码图片
动态生成二维码 PNG,内容为 http://<host>/s/{short},可用于制牌打印与批量排版。
<img src="/qr/a1b2c3d4">
GET/print?codes={code,code} 门牌批量打印页
按 A4 双列排版生成打印预览,自动调用二维码接口,可直接打印制牌。