活體檢驗(yàn)API在不同開(kāi)發(fā)語(yǔ)言中的調(diào)用（Java/python/php 示例）

通過(guò)HTTP POST請(qǐng)求向”開(kāi)放密唐”（miitang.com）活體檢驗(yàn)API提交面部照片。代碼使用了HttpUtils工具類，利用Apache HttpClient庫(kù)發(fā)送請(qǐng)求，并處理API返回的結(jié)果。通過(guò)設(shè)置請(qǐng)求頭、構(gòu)建參數(shù)體，代碼實(shí)現(xiàn)了對(duì)API的調(diào)用，并根據(jù)返回的HTTP狀態(tài)碼進(jìn)行邏輯處理。不同的狀態(tài)碼對(duì)應(yīng)了請(qǐng)求成功、用戶輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶操作頻度問(wèn)題、系統(tǒng)穩(wěn)定性問(wèn)題等不同情況，代碼在每種情況下輸出相應(yīng)的提示信息。這樣的代碼結(jié)構(gòu)清晰，提供了對(duì)接API的基本框架，并處理了各種可能的錯(cuò)誤場(chǎng)景。

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/live-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("facePhoto", "facePhoto");



        try {

            /**

             * 重要提示如下:

             * HttpUtils請(qǐng)從

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

             *

             * 相應(yīng)的依賴請(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){

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

            } else if(statusCode == 611){

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

            } else if(statusCode == 612){

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

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

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

            } else {

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

            }

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

}

在Python中，通過(guò)構(gòu)建JSON格式的payload，包含面部照片信息，并設(shè)置相應(yīng)的請(qǐng)求頭，包括Content-Type和X-Mce-Signature。代碼根據(jù)API返回的HTTP狀態(tài)碼（status_code）進(jìn)行邏輯處理，分別處理請(qǐng)求成功、用戶輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶操作頻度問(wèn)題等不同情況，并輸出相應(yīng)的提示信息。此外，對(duì)于系統(tǒng)穩(wěn)定性問(wèn)題，代碼建議重試或聯(lián)系客服。這示例代碼提供了一種簡(jiǎn)潔而清晰的方式來(lái)使用Python與活體檢驗(yàn)API進(jìn)行通信和錯(cuò)誤處理。

import json

import requests



if __name__ == '__main__':



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



    payload = json.dumps({

        "facePhoto": "facePhoto"

    })



    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 :

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

    elif status_code == 611 :

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

    elif status_code == 612 :

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

    elif status_code >= 500 & status_code < 600 :

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

    else:

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

在PHP中，通過(guò)POST請(qǐng)求向API提交面部照片，并根據(jù)API返回的結(jié)果進(jìn)行邏輯處理。其中，通過(guò)HTTP狀態(tài)碼（$httpCode）和業(yè)務(wù)碼（$retMap[“code”]）來(lái)判斷請(qǐng)求的成功與失敗，以及具體的錯(cuò)誤類型。根據(jù)不同的情況，代碼輸出相應(yīng)的信息，如成功提示、用戶輸入?yún)?shù)問(wèn)題、系統(tǒng)數(shù)據(jù)問(wèn)題、用戶操作頻度問(wèn)題等。此外，對(duì)于系統(tǒng)穩(wěn)定性問(wèn)題，代碼建議重試。這示例代碼提供了一種簡(jiǎn)單而清晰的方式來(lái)集成活體檢驗(yàn)API并處理各種可能的返回情況。

<?php

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

    $path = "/v1/tools/person/live-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 = "facePhoto=facePhoto";

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

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

            $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 提示用戶

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

        } else if($httpCode == 612){

            // 用戶操作頻度問(wèn)題，可提示用戶。  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)題，客戶端可以重試，或者聯(lián)系我司客服

            // TODO: retry

            echo "RETRY".PHP_EOL;

        } else {

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

            var_dump($retMap);

        }

    }

?>

總結(jié)

?活體檢驗(yàn)API基于生物特征進(jìn)行身份驗(yàn)證，為各行業(yè)提供了安全、高效的解決方案。通過(guò)實(shí)時(shí)觀察、測(cè)試或分析用戶的生物信息，確保身份驗(yàn)證的真實(shí)性。多模態(tài)支持、便捷的API集成和實(shí)時(shí)活體檢測(cè)增強(qiáng)了其適用性。在金融、醫(yī)療、社交媒體等領(lǐng)域廣泛應(yīng)用，提高了安全性和用戶體驗(yàn)。對(duì)錯(cuò)誤的靈活處理機(jī)制使其更具可靠性。活體檢驗(yàn)API代表了身份驗(yàn)證領(lǐng)域的創(chuàng)新，為數(shù)字化社會(huì)提供了可信賴的身份確認(rèn)手段。

上一篇：

如何使用冪簡(jiǎn)集成提供的預(yù)集成服務(wù)？

下一篇：

視頻實(shí)名認(rèn)證API在Java、Python、PHP中的使用教程
#你可能也喜歡這些API文章!

我們有何不同？

API服務(wù)商零注冊(cè)

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型，提升決策效率

查看全部API→
??

熱門(mén)場(chǎng)景實(shí)測(cè)，選對(duì)API

#AI文本生成大模型API

對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對(duì)比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)