身份证归属地

GET
https://v2.openode.cn/api/idcard
https://api.auth.top/api/idcard

服务指标

QPS 上限
30次/秒
平均响应时间
1ms

接口描述

根据身份证号码解析持有人户籍所在地、性别、出生日期等信息的接口。

请求参数

怎么传递这个 Key？
推荐
方法 1：Bearer Token (Header)
标准规范，兼容性最好，最安全
Authorization:Bearer Key
方法 2：放在请求头 (Header)
直接使用 Authorization，无需前缀
Authorization:Key
方法 3：放在请求头 (Header)
自定义 Header key 字段
key:Key
不推荐
方法 4：放在网址后面 (Query)
不安全，可能泄露 Key，即将弃用
网址?key=Key

请求示例

Shell
JavaScript
Python
PHP
Java
Go
C#
Ruby
curl -X GET 'https://v2.openode.cn/api/idcard?idcard=${身份证号码}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "code": 1,
  "msg": "查询成功",
  "data": {
    "idcard": "5xxxxxxxxxxxxxxxxx",
    "area": "云南省 昆明地区 五华区",
    "gender": "男",
    "birthday": "1999年09月09日",
    "valid": false
  }
}