身份实名认证接口【阿里云云市场】

1. 前言

阿里云云市场实名认证接口

最近在做一个手机 APP 项目，需要用到实名认证接口，这是公司在阿里云云市场找的一个接口

2. 代码示例

将下面函数中的 appcode 修改为云市场的真实 appcode 即可使用

/**
* 阿里云实名认证 API
* @param  $realName 姓名
* @param  $cardNo   身份证号
* @return boolean   true|false 认证成功|认证失败
*/
function identityAuth($realName, $cardNo)
{
    $host    = "https://zid.market.alicloudapi.com";
    $path    = "/idcheck/Post";
    $method  = "POST";
    $appcode = '';
    if (empty($appcode)) {
        throw new \Exception("未配置 App Code");
    }
    $headers = [
        "Authorization:APPCODE {$appcode}",
        "Content-Type:application/x-www-form-urlencoded; charset=UTF-8",
    ];
    $bodys = "cardNo={$cardNo}&realName={$realName}";
    $url = $host . $path;
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_FAILONERROR, false);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    if (1 == strpos("$" . $host, "https://")) {
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    }
    curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
    $result = curl_exec($curl);
    if (empty($result)) {
        throw new \Exception("实名认证接口异常");
    }
    $array = json_decode($result, true);
    if ($array['error_code'] == 0 && $array['result']['isok'] === true) {
        return true; // 认证成功
    } else {
        return false; // 认证失败
    }
}

调用示例

// 调用 API 进行实名认证
if (!identityAuth($name, $idcard)) {
    throw new \Exception("认证失败,请检查填写的信息");
}

3. 返回值示例

本文介绍的 API 返回值示例，也就是 identityAuth() 函数中的 $result 的值

特别注意: error_code 只表示 API 请求成功，实名认证结果必须使用 result.isok 判断

认证成功时的返回值: 当姓名和身份证号码匹配时, 认证成功，isok 的值为 true

{
    "error_code":0,
    "reason":"成功",
    "result":{
        "realname":"梁**",
        "idcard":"410225************",
        "isok":true,
        "IdCardInfor":{
            "province":"河南省",
            "city":"开封市",
            "district":"兰考县",
            "area":"河南省开封市兰考县",
            "sex":"男",
            "birthday":"1999-10-16"
        }
    },
    "sn":"0809093446637651130008663231"
}

认证失败时的返回值: 当姓名和身份证号码错误或不匹配时, 返回值如下所示，isok 的值为 false

{
    "error_code":0,
    "reason":"成功",
    "result":{
        "realname":"张*",
        "idcard":"410225************",
        "isok":false,
        "IdCardInfor":null
    },
    "sn":"080909320535865586360802173"
}