身份证号码归属地查询

说明

根据身份证号码查询所在归属地、性别、出生年月日等

相关接口
身份证实名认证二要素效验(身份证号码+姓名)

测试示例: https://sapi.k780.com/?app=idcard.get&idcard=110101199001011114&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json (示例中sign会不定期调整)

调用方式

Get/Post

请求url

 HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com

请求参数

Json请求示例

http://api.k780.com/?app=idcard.get&idcard=110101199001011114&appkey=APPKEY&sign=SIGN&format=json

Json返回示例

1. 查询及效验成功 status = ALREADY_ATT
{
    "success": "1",
    "result": {
        "status": "ALREADY_ATT", /*状态*/
        "idcard": "110101199001011114", /*查询的身份证号码*/
        "par": "110101", /*身份证前缀*/
        "born": "1990年01月01日", /*出生年月日*/
        "sex": "男", /*性别*/
        "att": "北京市 东城区 ", /*归属地*/
        "postno": "100000", /*邮编*/
        "areano": "010", /*区号*/
        "style_simcall": "中国,北京", /*地区1*/
        "style_citynm": "中华人民共和国,北京市" /*地区2*/
    }
}

2.等待系统处理  status = WAIT_PROCESS (此种类型不扣量/扣费)
{
    "success":"1",
    "result":{
        "status":"WAIT_PROCESS",
        "par": "",
        "born": "",
        "sex": "",
        "att": "",
        "postno": "",
        "areano": "",
        "style_simcall": "",
        "style_citynm": "",
        "msg": "wait process"
    }
}

3.无归属地信息  status = NOT_ATT
{
    "success":"1",
    "result":{
        "status":"NOT_ATT",
        "idcard": "110101199001011112",
        "par": "",
        "born": "",
        "sex": "",
        "att": "",
        "postno": "",
        "areano": "",
        "style_simcall": "",
        "style_citynm": "",
        "msg": "暂无归属地信息"
    }
}

4.身份证号码错误(含效验失败)  status = WRONG_IDCARD
{
    "success":"1",
    "result":{
        "status": "WRONG_IDCARD",
        "idcard": "110101199001011112",
        "par": "",
        "born": "",
        "sex": "",
        "att": "",
        "postno": "",
        "areano": "",
        "style_simcall": "",
        "style_citynm": "",
        "msg": "身份证号码不正确"
    }
}

5.系统级别错误
{
    "success":"0",
    "msgid":"...",
    "msg":"..."
}

示例代码

• PHP
• Python
• Java
• Curl

<?php
header("Content-Type:text/html;charset=UTF-8");
function nowapiRequest($postData,&$errMsg=''){
    $apiUrl     = 'https://sapi.k780.com/';
    $useContext = stream_context_create(array(
        'http' => array(
            'method'  => 'POST',
            'header'  => 'Content-type:application/x-www-form-urlencoded',
            'content' => http_build_query($postData)
        )
    ));
    if(!$resData=file_get_contents($apiUrl,false,$useContext)){
        $errMsg = 'ERR_CONNECT';
        return false;
    }
    if(!$arrData=json_decode($resData,true)){
        $errMsg = 'ERR_DECODE';
        return false;
    }
    if($arrData['success']!=1){
        $errMsg = $arrData['msgid'].' '.$arrData['msg'];
        return false;
    }
    return $arrData['result'];
}

$postData['app'] = 'idcard.get';
$postData['idcard'] = '110101199001011114';
$postData['appkey'] = '10003';//替换成自己的appkey
$postData['sign'] = 'b59bc3ef6191eb9f747dd4e83c99f2a4';//替换成自己的sign
$postData['format'] = 'json';
$result = nowapiRequest($postData,$errMsg);
print_r($errMsg);
print_r($result);

#python
import json,urllib
from urllib import urlencode

url = 'http://api.k780.com'
params = {
  'app' : 'idcard.get',
  'idcard' : '110101199001011114',
  'appkey' : 'APPKEY',
  'sign' : 'SIGN',
  'format' : 'json',
}
params = urlencode(params)

f = urllib.urlopen('%s?%s' % (url, params))
nowapi_call = f.read()
#print content
a_result = json.loads(nowapi_call)
if a_result:
  if a_result['success'] != '0':
    print a_result['result'];
  else:
    print a_result['msgid']+' '+a_result['msg']
else:
  print 'Request nowapi fail.';

import java.net.*;
import java.io.*;

public class test{
    public static void main(String args[]) throws Exception {
        URL u=new URL("http://api.k780.com/?app=idcard.get&idcard=110101199001011114&appkey=APPKEY&sign=SIGN&format=json");
        InputStream in=u.openStream();
        ByteArrayOutputStream out=new ByteArrayOutputStream();
        try {
            byte buf[]=new byte[1024];
            int read = 0;
            while ((read = in.read(buf)) > 0) {
                out.write(buf, 0, read);
            }
        }  finally {
            if (in != null) {
                in.close();
            }
        }
        byte b[]=out.toByteArray( );
        System.out.println(new String(b,"utf-8"));
    }
}

curl "http://api.k780.com/?app=idcard.get&idcard=110101199001011114&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"