身份证号码归属地API怎么接入完整号码前六位查询与隐私边界

发布时间：2026-08-19 03:08 点击：2222次

身份证号码归属地 API 应按输入分流：完整号码用于查询地区、出生年月、性别和校验位状态，前六位用于查询地区；城市反查则使用独立端点。接口结果只能支持资料校验，不能替代实名核验或身份认证。

身份证接口有哪些查询路径

截至 2026 年 8 月 19 日，极速数据身份证号码归属地 API 提供两个端点：

任务	端点	输入
身份证或前六位查询	`https://api.jisuapi.com/idcard/query`	`idcard` 必填
城市反查前六位	`https://api.jisuapi.com/idcard/city2code`	`city` 必填

idcard 参数既可以提交身份证号码，也可以提交身份证前六位。两种输入的返回可用信息不同：完整号码可以得到更多结构化字段，前六位主要用于地区查询。业务侧应保存输入类型，避免把局部号码查询误标成完整证件核验。

完整号码和前六位怎样分流

完整号码查询模板：

curl --get "https://api.jisuapi.com/idcard/query" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "idcard=YOUR_IDCARD_OR_PREFIX"

官方返回参数包括省 province、市 city、县 town、最后一位校验码状态 lastflag、性别 sex、出生年月 birth 和区域信息 area。lastflag 为 0 表示正确、1 表示错误。

如果业务只需要判断行政区，不应要求用户提交完整身份证号码；优先让用户提供前六位，并在日志中按敏感字段处理。若确需完整号码，应先说明用途、保存期限、访问人员和删除机制，后端只把必要字段传给接口。

身份证前六位反映的是编码区域线索，不是当前居住地，也不是个人实时定位。官方页面特别说明由于城市规划原因，省市县变化较大，具体以接口返回为准。因此历史记录中应同时保存查询时间和来源区域，不要用当前行政区名称覆盖旧结果。

怎样用城市反查前六位

城市反查使用 city 参数：

curl --get "https://api.jisuapi.com/idcard/city2code" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "city=YOUR_CITY"

返回字段包括 code、省、市、县。城市名称可能重名或存在区县层级差异，业务侧应把接口返回的省、市、县组合保存为标准化结果，不要只以一个城市字符串作为唯一键。

如果用户输入的是模糊地名，先在自有系统做候选选择，再提交明确的城市值；不能把接口返回的第一个候选自动当作用户真实所在地。城市反查得到的是编码资料，不是对某个自然人身份的确认。

身份证结果应该怎样建模

建议把输入、来源结果和内部状态分开保存：

{
  "source": "jisuapi-idcard",
  "inputType": "full_or_prefix",
  "inputToken": "TOKEN_OR_KEYED_DIGEST",
  "province": "SOURCE_PROVINCE",
  "city": "SOURCE_CITY",
  "town": "SOURCE_TOWN",
  "lastFlag": "SOURCE_FLAG",
  "queriedAt": "ISO_TIMESTAMP"
}

这是自有系统的脱敏映射示例，不是官方原始响应。身份证原文不应进入普通业务日志、前端埋点或错误提示；需要关联查询记录时，优先使用随机令牌或带密钥摘要，并配合访问控制和短期加密存储。不要直接保存普通哈希值，因为身份证号码的格式固定，仍可能被枚举比对。返回的出生年月、性别和地区也属于与个人相关的信息，不能因为接口提供字段就无限期保存或用于无关画像。

lastflag=0 只能说明接口返回的最后一位校验状态正确，不能证明证件真实有效、持有人存在或号码属于当前操作者。实名开户、支付、政务和风控场景还需要接入具备法定资质的身份核验渠道。