Java

1. 在pom.xml中添加如下依賴，即可在Maven工程中使用SDK。

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>aliyun-java-sdk-saf</artifactId>
       <version>3.0.2</version>
   </dependency>
   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>credentials-java</artifactId>
       <version>LATEST</version>
   </dependency>

   推薦Maven依賴仲裁：

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>aliyun-java-sdk-core</artifactId>
       <optional>true</optional>
       <version>4.6.4</version>
   </dependency>
   <dependency>
       <groupId>com.alibaba</groupId>
       <artifactId>fastjson</artifactId>
       <version>2.0.47</version>
   </dependency>
   <dependency>
       <groupId>com.google.code.gson</groupId>
       <artifactId>gson</artifactId>
       <version>2.10.1</version>
   </dependency>
   <dependency>
           <groupId>com.aliyun</groupId>
           <artifactId>tea</artifactId>
           <version>LATEST</version>
   </dependency>

   說明

   • 配置Java SDK環境的具體操作請參見阿里云SDK開發指南。

   • 您可以通過站點1和站點2獲得對應的Maven依賴。

   • Credentials工具配置方法，請參見在Linux、macOS和Windows系統配置環境變量。

2. 示例代碼如下：

   import java.io.IOException;
   import java.util.HashMap;
   import java.util.Map;
   import com.alibaba.fastjson.JSON;
   import com.aliyuncs.CommonRequest;
   import com.aliyuncs.CommonResponse;
   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.IAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.exceptions.ServerException;
   import com.aliyuncs.http.FormatType;
   import com.aliyuncs.http.MethodType;
   import com.aliyuncs.http.ProtocolType;
   import com.aliyuncs.profile.DefaultProfile;
   
   public class FaceVerifyTest {
       public static void main(String[] args) throws IOException {
   
           // 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
           // 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
           // 本示例通過阿里云Credentials工具從環境變量中讀取AccessKey，來實現API訪問的身份驗證。
           com.aliyun.credentials.Client credentialClient = new com.aliyun.credentials.Client();
           String accesssKeyId = credentialClient.getCredential().getAccessKeyId();
           String accessKeySecret = credentialClient.getCredential().getAccessKeySecret();
   
           DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai",accesssKeyId,accessKeySecret);
           IAcsClient client = new DefaultAcsClient(profile);
   
           CommonRequest request = new CommonRequest();
           request.setSysMethod(MethodType.POST);
   
           request.setSysDomain("saf.cn-shanghai.aliyuncs.com");
           request.setSysVersion("2017-03-31");
           request.setSysAction("ExecuteRequest");
           request.setSysProtocol(ProtocolType.HTTPS);
           request.setHttpContentType(FormatType.FORM);
   
           // 業務詳細參數。
           Map<String, Object> serviceParams = new HashMap<String, Object>();
   
           // 發起認證請求。
           serviceParams.put("method",  "init");
           serviceParams.put("sceneId",  "100001***");
           // outerOrderNo參數要求每次都唯一，建議使用UUID工具每次生成。
           serviceParams.put("outerOrderNo",  UUID.randomUUID().toString().replaceAll("-",""));
   
           // 當用戶在iOS或安卓平臺發起認證時，認證場景碼是FACE_SDK；在小程序中，認證場景碼則為FACE。
           serviceParams.put("bizCode", "FACE");
           serviceParams.put("identityType", "CERT_INFO");
           serviceParams.put("certType", "IDENTITY_CARD");
           serviceParams.put("certNo", "142702******");
           serviceParams.put("certName", "張三");
           // 認證后回調的頁面地址。
           serviceParams.put("returnUrl", "");
           //serviceParams.put("callbackUrl", "https://www.aliyundoc.com");
           //serviceParams.put("callbackToken", "NMjvQanQgplBSaEI0sL86WnQplB");
   
           /*
           // 如需開啟個人信息加密傳輸。
           serviceParams.put("encryptType",  "SM2");
           serviceParams.put("certNo", "BMjsstxK3S4b1YH*****Pet8ECObfxmLN92SLsNg==");
           serviceParams.put("certName", "BCRD/7ZkNy7Q*****M1BMBezZe8GaYHrLwyJv558w==");
           */
   
           // 查詢認證結果。
           //serviceParams.put("method",  "query");
           //serviceParams.put("certifyId", "7eace0bcc45a07940d0c50cb69***");
           //serviceParams.put("sceneId", "100001***");
   
           request.putBodyParameter("ServiceParameters", JSON.toJSONString(serviceParams));
           // 固定值，Service = fin_face_verify。
           request.putBodyParameter("Service", "fin_face_verify");
   
           try {
               CommonResponse response = client.getCommonResponse(request);
               System.out.println(response.getData());
           } catch (ServerException e) {
               e.printStackTrace();
           } catch (ClientException e) {
               e.printStackTrace();
           }
       }
   }

Python

PHP

C#

Golang

Node.js