3. API 集成： 開(kāi)發(fā)者按照文檔中的指引，將 API 集成到自己的應(yīng)用程序中。

4. API 管理： 在冪簡(jiǎn)集成平臺(tái)上，可以管理 API 密鑰、查看使用情況和監(jiān)控身份驗(yàn)證請(qǐng)求。

企業(yè)公戶(hù)驗(yàn)證API在不同開(kāi)發(fā)語(yǔ)言中的調(diào)用（Java/python/php 示例）

在Java中，下面這段代碼展示了如何使用 Java 發(fā)送 HTTP POST 請(qǐng)求到企業(yè)公戶(hù)驗(yàn)證服務(wù)，以及如何處理服務(wù)的響應(yīng)。需要注意的是，其中的 HttpUtils 類(lèi)和依賴(lài)項(xiàng)需要從提供的鏈接下載并引入。此外，{{AppCode}} 部分需要替換為實(shí)際的應(yī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 BankAccountVerifier {

    private static final String HOST_URL = "https://open.explinks.com";

    private static final String PATH = "/v1/tools/verify/company/bank-verify";

    private static final String METHOD_POST = "POST";

    private static final String CONTENT_TYPE = "application/x-www-form-urlencoded; charset=UTF-8";



    public static void main(String[] args) {

        try {

            verifyBankAccount("yourAppCodeHere", "bankCard", "companyName", "bankUnionCode");

        } catch (Exception e) {

            System.err.println("An error occurred during bank account verification: " + e.getMessage());

            e.printStackTrace();

        }

    }



    /**

     * Verifies a company's bank account using the Explinks API.

     *

     * @param appCode      The application code for authentication.

     * @param bankCard     The bank card number to be verified.

     * @param companyName  The name of the company owning the bank account.

     * @param bankUnionCode The union code of the bank.

     * @throws Exception If an error occurs during the HTTP request.

     */

    public static void verifyBankAccount(String appCode, String bankCard, String companyName, String bankUnionCode) throws Exception {

        Map<String, String> headers = prepareHeaders(appCode);

        Map<String, String> bodys = prepareRequestBody(bankCard, companyName, bankUnionCode);

        HttpResponse response = HttpUtils.doPost(HOST_URL, PATH, METHOD_POST, headers, new HashMap<>(), bodys);

        processResponse(response);

    }



    private static Map<String, String> prepareHeaders(String appCode) {

        Map<String, String> headers = new HashMap<>();

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

        headers.put("Content-Type", CONTENT_TYPE);

        return headers;

    }



    private static Map<String, String> prepareRequestBody(String bankCard, String companyName, String bankUnionCode) {

        Map<String, String> bodys = new HashMap<>();

        bodys.put("bankCard", bankCard);

        bodys.put("companyName", companyName);

        bodys.put("bankUnionCode", bankUnionCode);

        return bodys;

    }



    private static void processResponse(HttpResponse response) throws Exception {

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

        System.out.println(responseBody);

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

        switch (statusCode) {

            case 200:

                // Handle successful response based on business code in responseBody

                break;

            case 610:

                System.err.println("Invalid input parameters.");

                break;

            case 611:

                System.err.println("System data issue.");

                // Consider logging this event

                break;

            case 612:

                System.err.println("Frequency limit exceeded.");

                // Log and handle as per business logic

                break;

            default:

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

                    System.err.println("Server stability issue. Retrying or contacting support is advised.");

                } else {

                    System.err.println("Error occurred. Check your credentials, IP whitelist, balance, etc.");

                }

        }

    }

}

在Python中，使用 requests 庫(kù)發(fā)送 POST 請(qǐng)求到企業(yè)公戶(hù)驗(yàn)證服務(wù)接口，根據(jù)響應(yīng)狀態(tài)碼進(jìn)行業(yè)務(wù)邏輯處理，包括成功、參數(shù)問(wèn)題、數(shù)據(jù)問(wèn)題、操作頻度問(wèn)題和系統(tǒng)穩(wěn)定性問(wèn)題等的處理。

import json

import requests



if __name__ == '__main__':



    url = "https://open.explinks.com/v1/tools/verify/company/bank-verify"



    payload = json.dumps({

        "bankCard": "bankCard",

        "companyName": "companyName",

        "bankUnionCode": "bankUnionCode"

    })



    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中，使用 cURL 發(fā)送 POST 請(qǐng)求到企業(yè)公戶(hù)驗(yàn)證服務(wù)接口，處理并輸出相應(yīng)的業(yè)務(wù)邏輯。它包括設(shè)置請(qǐng)求頭、發(fā)送請(qǐng)求、處理響應(yīng)，根據(jù)響應(yīng)狀態(tài)碼進(jìn)行不同的業(yè)務(wù)邏輯處理，如成功、參數(shù)問(wèn)題、數(shù)據(jù)問(wèn)題、操作頻度問(wèn)題、系統(tǒng)穩(wěn)定性問(wèn)題等。

<?php

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

    $path = "/v1/tools/verify/company/bank-verify";

    $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 = "bankCard=bankCard&companyName=companyName&bankUnionCode=bankUnionCode";

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

企業(yè)公戶(hù)驗(yàn)證API是企業(yè)在數(shù)字化時(shí)代中的重要工具之一。它通過(guò)自動(dòng)化和數(shù)字化方式，幫助企業(yè)快速、準(zhǔn)確地進(jìn)行對(duì)公賬戶(hù)的認(rèn)證和驗(yàn)證。企業(yè)公戶(hù)驗(yàn)證API的出現(xiàn)推動(dòng)了企業(yè)金融業(yè)務(wù)的創(chuàng)新和發(fā)展，提升了賬戶(hù)認(rèn)證流程的效率和安全性，為企業(yè)在金融領(lǐng)域的數(shù)字化轉(zhuǎn)型提供了有力支持。

作者：幻城