身份证实名认证

身份证号码合法性验证+解析详情(含地区、生日、性别、年龄、星座)

接口状态
正常
请求方式
GET
数据格式
json
计费方式
¥免费

接口详情

接口地址

https://api.yxzy.cc/api/idcard

接口标签

GET json 正常 免费

接口描述

身份证号码合法性验证+解析详情(含地区、生日、性别、年龄、星座)

请求参数

参数名 类型 必填 说明 示例
apikey 必填 string 你开通的apikey -
idcard 必填 string 身份证号码 -
type string verify=基础验证 detail=详细信息 -

返回参数

参数名 类型 说明 示例
code int 状态码 0成功 -
msg string 提示信息 -
data.valid bool 是否有效 -
data.idcard string 身份证号 -
data.province string 省份 -
data.birthday string 出生日期 -
data.gender string 性别 -
data.age int 年龄 -
data.zodiac string 生肖 -
data.constellation string 星座 -

请求示例

cURL
PHP
Python
Node.js
cURL示例

curl -X GET "https://api.yxzy.cc/api/idcard"
  -d "apikey=value"
  -d "idcard=value"
                                    

响应示例

成功响应

JSON响应
{"code":0,"data":{"valid":true,"idcard":"110101199003074567","length":18,"province":"北京市","province_code":"11","birthday":"1990-03-07","gender":"女","age":36,"zodiac":"马","constellation":"双鱼座"},"msg":"验证成功"}

错误代码

以下是通用错误代码说明:

状态码 状态 说明 解决方案
0 成功 请求成功,返回所需数据 正常处理返回数据
-1 缺少API秘钥 API密钥不能为空! 检查请求参数是否符合要求
-1 秘钥无效 API密钥不存在或无效! 检查API密钥是否正确
-1 账号已被封禁 账号已被禁止使用 检查账户权限
-1 接口不存在/接口已下架 请求的接口地址不存在 检查接口地址是否正确
-1 当前接口需要实名认证才可以使用 登录网站进行实名认证 有些接口需要实名
-1 余额不足 账户余额不足无法调用按此计费接口 请及时充值余额
-1 请先开通包月服务 按月付费接口 请开通包月使用
-1 会员已到期 按月接口到期 请续费包月使用
-1 当前用户无权限调用 VIP会员专用接口 请开通对应的会员进行使用