小白开放接口

身份证号码解析

接口地址:http://api.okayapi.com/?s=App.Common_IDCard.Parse

接口描述: 基于「公民身份号码」规则,获取身份证号码中包含的基础信息组件。仅用于开发和测试,不得用于商业用途。

接口标签:免费(每月最高10万次)付费(1元/1万次)  验签

请求协议
HTTP/HTTPS
请求方式
GET/POST(推荐POST)
编码格式
UTF-8
返回格式
JSON

在线测试    添加收藏    直接访问接口    阅读:加载中...


接口参数

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小:32;最大:32开发者应用的app_key,查看我的app_key,如果还没有,可免费注册开通。
sign字符串可选动态签名,签名生成算法请见:如何生成签名,或直接使用封装好的SDK开发包。如果不需要签名,可进入小白开放平台接口签名设置关闭或开启签名。通过在线测试工具可进行签名的对比和调试。
uuid字符串可选最大:32UUID,当前登录的应用会员ID,即全局唯一用户ID,查看我的应用会员。
token字符串可选最小:64;最大:64当前登录会员的会话凭证,可通过会员登录接口获得。
id_number字符串必须身份证号码

返回结构说明

返回字段类型说明
ret整型接口状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务端异常,查看异常错误码
data.info.is_legal布尔型检查公民身份号码是否合法,true | false
data.info.birthday字符串公民身份号码中包含的生日信息,如:1989-06-18
data.info.age整型根据生日计算的年龄
data.info.gender字符串身份证包含的性别信息,女 | 男
data.info.code字符串GB/T 2260 的地区行政代码
data.info.province字符串省份名称或者直辖市名称
data.info.city字符串城市名称,如果是直辖市则返回 ''
data.info.area字符串区县名称
data.info.address字符串完整的地址
msg字符串提示信息,面向技术人员的帮助或错误提示信息

在线测试

参数是否必填
s 必须
uuid 可选
token 可选
id_number 必须

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

<?php

// 引入文件
require_once dirname(__FILE__) . '/OkayApiClient.php';

// 调用小白开放接口
$rs = OkayApiClient::request('App.Common_IDCard.Parse',array('id_number'=>'441324197708283657'));
// 输出结果
print_r($rs);


/*
Array 
( 
	[ret] => 200 
	[data] => Array 
	( 
		[err_code] => 0 
		[err_msg] => 
		[info] => Array 
		( 
			[is_legal] => 
			[birthday] => 1977-08-28 
			[age] => 41 
			[gender] => 男 
			[code] => 441324 
			[province] => 广东省
			[city] => 惠州市 
			[area] => 龙门县
			[address] => 广东省惠州市龙门县 
		) 
	) 
	[msg] => 小白开放接口:App.Common_IDCard.Parse 
)
*/

接口使用帮助说明

小白君正在拼命补充中……

猜你喜欢