活體檢驗API在不同開發語言中的調用（Java/python/php 示例）

通過HTTP POST請求向”開放密唐”（miitang.com）活體檢驗API提交面部照片。代碼使用了HttpUtils工具類，利用Apache HttpClient庫發送請求，并處理API返回的結果。通過設置請求頭、構建參數體，代碼實現了對API的調用，并根據返回的HTTP狀態碼進行邏輯處理。不同的狀態碼對應了請求成功、用戶輸入參數問題、系統數據問題、用戶操作頻度問題、系統穩定性問題等不同情況，代碼在每種情況下輸出相應的提示信息。這樣的代碼結構清晰，提供了對接API的基本框架，并處理了各種可能的錯誤場景。

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

        // 填充參數

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



        try {

            /**

             * 重要提示如下:

             * HttpUtils請從

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

             *

             * 相應的依賴請參照

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

                // 請求成功，可根據業務碼（請求體中的code）進行邏輯處理

            } else if(statusCode == 610){

                // 用戶輸入的參數問題，可直接提示用戶

            } else if(statusCode == 611){

                // 系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。  LOG it and 提示用戶

            } else if(statusCode == 612){

                // 用戶操作頻度問題，可提示用戶。  LOG it and 按業務特點做處理

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

                // 在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服

            } else {

                // 如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。

            }

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

}

在Python中，通過構建JSON格式的payload，包含面部照片信息，并設置相應的請求頭，包括Content-Type和X-Mce-Signature。代碼根據API返回的HTTP狀態碼（status_code）進行邏輯處理，分別處理請求成功、用戶輸入參數問題、系統數據問題、用戶操作頻度問題等不同情況，并輸出相應的提示信息。此外，對于系統穩定性問題，代碼建議重試或聯系客服。這示例代碼提供了一種簡潔而清晰的方式來使用Python與活體檢驗API進行通信和錯誤處理。

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 狀態碼:", str(status_code))

    print(response.text)

    if status_code == 200:

         "請求成功，可根據業務碼（請求體中的code）進行邏輯處理"

    elif status_code == 610 :

         "用戶輸入的參數問題，可直接提示用戶"

    elif status_code == 611 :

         "系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。  LOG it and 提示用戶"

    elif status_code == 612 :

        "用戶操作頻度問題，可提示用戶。  LOG it and 按業務特點做處理"

    elif status_code >= 500 & status_code < 600 :

         "在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服"

    else:

         "如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。"

在PHP中，通過POST請求向API提交面部照片，并根據API返回的結果進行邏輯處理。其中，通過HTTP狀態碼（$httpCode）和業務碼（$retMap[“code”]）來判斷請求的成功與失敗，以及具體的錯誤類型。根據不同的情況，代碼輸出相應的信息，如成功提示、用戶輸入參數問題、系統數據問題、用戶操作頻度問題等。此外，對于系統穩定性問題，代碼建議重試。這示例代碼提供了一種簡單而清晰的方式來集成活體檢驗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);

    //根據API的要求，定義相對應的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); // 獲得響應頭大小

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

        // 請求成功，可根據業務碼（請求體中的code）進行邏輯處理

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

            // 用戶輸入的參數問題，可直接提示用戶

            $errors = $retMap["errors"];

            $errorMap = null;

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

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

                  $errorMap[$key] = $value2;

                  break;

                }

            }

            // 轉化為 key:tip

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

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

        } else if($httpCode == 611){

            // 系統準備的數據問題，如 文件數據下載失敗、數據不存在、數據重復請求等。  LOG it and 提示用戶

            echo "修訂數據狀態，不要重復操作。".PHP_EOL;

        } else if($httpCode == 612){

            // 用戶操作頻度問題，可提示用戶。  LOG it and 按業務特點做處理

            echo $retMap["message"].PHP_EOL;

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

            // 在運行階段發生的系統穩定性問題，客戶端可以重試，或者聯系我司客服

            // TODO: retry

            echo "RETRY".PHP_EOL;

        } else {

            // 如賬戶密碼錯誤、IP白名單問題、余額不足等，您應該在對接過程中解決相關問題。

            var_dump($retMap);

        }

    }

?>

總結

?活體檢驗API基于生物特征進行身份驗證，為各行業提供了安全、高效的解決方案。通過實時觀察、測試或分析用戶的生物信息，確保身份驗證的真實性。多模態支持、便捷的API集成和實時活體檢測增強了其適用性。在金融、醫療、社交媒體等領域廣泛應用，提高了安全性和用戶體驗。對錯誤的靈活處理機制使其更具可靠性。活體檢驗API代表了身份驗證領域的創新，為數字化社會提供了可信賴的身份確認手段。

上一篇：

如何使用冪簡集成提供的預集成服務？

下一篇：

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

我們有何不同？

API服務商零注冊

多API并行試用

數據驅動選型，提升決策效率

查看全部API→
??

熱門場景實測，選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費