• API 集成： 開(kāi)發(fā)者按照文檔中的指引，將 API 集成到自己的應(yīng)用程序中。
• API 管理： 在冪簡(jiǎn)集成平臺(tái)上，可以管理 API 密鑰、查看使用情況和監(jiān)控身份驗(yàn)證請(qǐng)求。

人臉實(shí)名認(rèn)證API在不同開(kāi)發(fā)語(yǔ)言中的調(diào)用（Java/python/php 示例）

在Java中，使用HttpUtils類(lèi)進(jìn)行POST請(qǐng)求，向指定的API地址傳遞身份信息，同時(shí)設(shè)置請(qǐng)求頭和請(qǐng)求體。根據(jù)API返回的HTTP狀態(tài)碼，實(shí)現(xiàn)了不同情況下的邏輯處理，包括成功情況、用戶(hù)輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶(hù)操作頻度問(wèn)題、系統(tǒng)穩(wěn)定性問(wèn)題等。該代碼以簡(jiǎn)潔的方式展示了Java中調(diào)用API的常用操作，通過(guò)異常處理機(jī)制提高了代碼的穩(wěn)健性。開(kāi)發(fā)者可以根據(jù)業(yè)務(wù)需求進(jìn)一步定制處理邏輯。

import com.mittang.util.HttpUtils;

import org.apache.http.HttpResponse;

import org.apache.http.util.EntityUtils;

import java.util.HashMap;

import java.util.Map;



public class Example {

    public static void main(String[] args) throws Exception{

        String host = "https://open.miitang.com";

        String path = "/v1/tools/person/id-with-photo";

        String method = "POST";

        // "{{AppCode}}" 替換成您的 AppCode

        String appcode = "{{AppCode}}";

        Map headers = new HashMap<>();

        headers.put("X-Mce-Signature", "AppCode/" + appcode);

        headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");

        Map querys = new HashMap<>();

        Map bodys = new HashMap<>();

        // 填充參數(shù)

        bodys.put("name", "name");

        bodys.put("idCardNo", "idCardNo");

        bodys.put("checkAlive", "checkAlive");



        try {

            /**

             * 重要提示如下:

             * HttpUtils請(qǐng)從

             * https://static.miitang.com/saas/simple/HttpUtils.java 下載

             *

             * 相應(yīng)的依賴(lài)請(qǐng)參照

             * https://static.miitang.com/saas/simple/pom.xml

             */

            HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);

            // 獲取 response 的 body

            String resStr = EntityUtils.toString(response.getEntity());

            System.out.println(resStr);

            int statusCode = response.getStatusLine().getStatusCode();

            if(statusCode == 200){

                // 請(qǐng)求成功，可根據(jù)業(yè)務(wù)碼（請(qǐng)求體中的code）進(jìn)行邏輯處理

            } else if(statusCode == 610){

                // 用戶(hù)輸入的參數(shù)問(wèn)題，可直接提示用戶(hù)

            } else if(statusCode == 611){

                // 系統(tǒng)準(zhǔn)備的數(shù)據(jù)問(wèn)題，如 文件數(shù)據(jù)下載失敗、數(shù)據(jù)不存在、數(shù)據(jù)重復(fù)請(qǐng)求等。  LOG it and 提示用戶(hù)

            } else if(statusCode == 612){

                // 用戶(hù)操作頻度問(wèn)題，可提示用戶(hù)。  LOG it and 按業(yè)務(wù)特點(diǎn)做處理

            } else if(statusCode >= 500 && statusCode < 600){

                // 在運(yùn)行階段發(fā)生的系統(tǒng)穩(wěn)定性問(wèn)題，客戶(hù)端可以重試，或者聯(lián)系我司客服

            } else {

                // 如賬戶(hù)密碼錯(cuò)誤、IP白名單問(wèn)題、余額不足等，您應(yīng)該在對(duì)接過(guò)程中解決相關(guān)問(wèn)題。

            }

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

}

在Python中，使用requests庫(kù)調(diào)用人臉實(shí)名認(rèn)證API的示例代碼。通過(guò)POST請(qǐng)求向指定URL傳遞JSON格式的身份信息，同時(shí)設(shè)置相應(yīng)的請(qǐng)求頭。根據(jù)API返回的HTTP狀態(tài)碼，實(shí)現(xiàn)了不同情況下的邏輯處理，包括成功情況、用戶(hù)輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶(hù)操作頻度問(wèn)題、系統(tǒng)穩(wěn)定性問(wèn)題等。通過(guò)輸出信息，可以根據(jù)業(yè)務(wù)需求進(jìn)行相應(yīng)的提示和處理，確保與人臉實(shí)名認(rèn)證API的對(duì)接能夠在不同情境下穩(wěn)健運(yùn)行。

import json

import requests



if __name__ == '__main__':



    url = "https://open.miitang.com/v1/tools/person/id-with-photo"



    payload = json.dumps({

        "name": "name",

        "idCardNo": "idCardNo",

        "checkAlive": "checkAlive"

    })



    headers = {

        "Content-Type": "application/json",

        # "{{AppCode}}" 替換為您的 AppCode

        "X-Mce-Signature": "AppCode/{{AppCode}}"

    }



    response = requests.request("POST", url, headers=headers, data=payload)

    status_code = response.status_code

    print("headers:", response.headers)

    print("http 狀態(tài)碼:", str(status_code))

    print(response.text)

    if status_code == 200:

         "請(qǐng)求成功，可根據(jù)業(yè)務(wù)碼（請(qǐng)求體中的code）進(jìn)行邏輯處理"

    elif status_code == 610 :

         "用戶(hù)輸入的參數(shù)問(wèn)題，可直接提示用戶(hù)"

    elif status_code == 611 :

         "系統(tǒng)準(zhǔn)備的數(shù)據(jù)問(wèn)題，如 文件數(shù)據(jù)下載失敗、數(shù)據(jù)不存在、數(shù)據(jù)重復(fù)請(qǐng)求等。  LOG it and 提示用戶(hù)"

    elif status_code == 612 :

        "用戶(hù)操作頻度問(wèn)題，可提示用戶(hù)。  LOG it and 按業(yè)務(wù)特點(diǎn)做處理"

    elif status_code >= 500 & status_code < 600 :

         "在運(yùn)行階段發(fā)生的系統(tǒng)穩(wěn)定性問(wèn)題，客戶(hù)端可以重試，或者聯(lián)系我司客服"

    else:

         "如賬戶(hù)密碼錯(cuò)誤、IP白名單問(wèn)題、余額不足等，您應(yīng)該在對(duì)接過(guò)程中解決相關(guān)問(wèn)題。"

在PHP中，通過(guò)cURL庫(kù)向指定的API地址發(fā)送POST請(qǐng)求，傳遞用戶(hù)提供的身份信息，然后解析返回的JSON格式結(jié)果。根據(jù)HTTP狀態(tài)碼和API返回的業(yè)務(wù)碼，實(shí)現(xiàn)了不同情況下的邏輯處理，包括成功情況、用戶(hù)輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶(hù)操作頻度問(wèn)題、系統(tǒng)穩(wěn)定性問(wèn)題等。通過(guò)輸出信息，可以根據(jù)業(yè)務(wù)需求進(jìn)行相應(yīng)的處理和提示，以確保對(duì)接人臉實(shí)名認(rèn)證API的穩(wěn)健性和友好性。

<?php

    $host = "https://open.miitang.com";

    $path = "/v1/tools/person/id-with-photo";

    $method = "POST";

    $appcode = "{{您的AppCode}}";

    $headers = array();

    array_push($headers, "x-mce-signature:AppCode/" . $appcode);

    //根據(jù)API的要求，定義相對(duì)應(yīng)的Content-Type

    array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");

    $querys = "";

    $bodys = "name=name&idCardNo=idCardNo&checkAlive=checkAlive";

    $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);

    curl_setopt($curl, CURLOPT_HEADER, 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);



    $header_size = curl_getinfo($curl, CURLINFO_HEADER_SIZE); // 獲得響應(yīng)頭大小

    $httpCode = curl_getinfo($curl,CURLINFO_HTTP_CODE);

    $body = substr($result,$header_size);



    curl_close($curl);

    $retMap = json_decode($body, true);

    $code = $retMap["code"];



    echo $httpCode.PHP_EOL; // DEBUG



    if($httpCode == 200){

        // 請(qǐng)求成功，可根據(jù)業(yè)務(wù)碼（請(qǐng)求體中的code）進(jìn)行邏輯處理

        echo $retMap["code"].PHP_EOL;

        echo $retMap["message"].PHP_EOL;

        echo $retMap["hasFees"].PHP_EOL;

        echo $retMap["fees"].PHP_EOL;

        if($code == "FP00000"){

            // SUCCESS

            echo "SUCCESS";

        }

        else{

            // FAILURE

            echo "FAILURE";

        }

    } else {

        echo $code.PHP_EOL; // DEBUG



        if($httpCode == 610){

            // 用戶(hù)輸入的參數(shù)問(wèn)題，可直接提示用戶(hù)

            $errors = $retMap["errors"];

            $errorMap = null;

            foreach($errors as $key=>$value){

                foreach($value as $key2=>$value2){

                  $errorMap[$key] = $value2;

                  break;

                }

            }

            // 轉(zhuǎn)化為 key:tip

            echo($errorMap["idCardNo"].PHP_EOL);

            echo($errorMap["name"].PHP_EOL);

        } else if($httpCode == 611){

            // 系統(tǒng)準(zhǔn)備的數(shù)據(jù)問(wèn)題，如 文件數(shù)據(jù)下載失敗、數(shù)據(jù)不存在、數(shù)據(jù)重復(fù)請(qǐng)求等。  LOG it and 提示用戶(hù)

            echo "修訂數(shù)據(jù)狀態(tài)，不要重復(fù)操作。".PHP_EOL;

        } else if($httpCode == 612){

            // 用戶(hù)操作頻度問(wèn)題，可提示用戶(hù)。  LOG it and 按業(yè)務(wù)特點(diǎn)做處理

            echo $retMap["message"].PHP_EOL;

        } else if($httpCode >= 500 && $httpCode < 600){

            // 在運(yùn)行階段發(fā)生的系統(tǒng)穩(wěn)定性問(wèn)題，客戶(hù)端可以重試，或者聯(lián)系我司客服

            // TODO: retry

            echo "RETRY".PHP_EOL;

        } else {

            // 如賬戶(hù)密碼錯(cuò)誤、IP白名單問(wèn)題、余額不足等，您應(yīng)該在對(duì)接過(guò)程中解決相關(guān)問(wèn)題。

            var_dump($retMap);

        }

    }

?>

總結(jié)

人臉實(shí)名認(rèn)證通過(guò)分析用戶(hù)面部特征，提供了高度安全且便捷的身份驗(yàn)證方式。其基于生物特征，如面部輪廓和眼睛，難以被偽造，有效降低了身份盜竊風(fēng)險(xiǎn)?？焖偾覠o(wú)需額外記憶的驗(yàn)證過(guò)程提高了用戶(hù)體驗(yàn)，廣泛應(yīng)用于金融、社交媒體、醫(yī)療保健等領(lǐng)域。開(kāi)放的API允許開(kāi)發(fā)者輕松集成到各應(yīng)用中，實(shí)時(shí)活體檢測(cè)進(jìn)一步保障驗(yàn)證真實(shí)性。全方位的錯(cuò)誤處理機(jī)制確保用戶(hù)能夠理解并解決可能出現(xiàn)的問(wèn)題。人臉實(shí)名認(rèn)證技術(shù)在現(xiàn)代社會(huì)中為身份驗(yàn)證提供了安全、高效的解決方案。

更多認(rèn)證相關(guān)API

身份證二要素

人臉比對(duì)

視頻實(shí)名認(rèn)證

#你可能也喜歡這些API文章!

API經(jīng)濟(jì) – 什么是API經(jīng)濟(jì)？

Java?API設(shè)計(jì)實(shí)戰(zhàn)指南：打造穩(wěn)健、用戶(hù)友好的API