Server-side integration

Add the dependency package for your programming language.

• Java

  (Recommended) Add the POM dependency for the Face & Body service to your Java project.

  <!-- https://mvnrepository.com/artifact/com.aliyun/facebody20200910 -->
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>facebody20200910</artifactId>
      <version>${aliyun.facebody.version}</version>
  </dependency>

  Alternatively, you can download the SDK package for the Face & Body service and reference it directly.

  AI category	SDK package name	SDK link	GitHub link
  Face & Body	facebody20200910	Aliyun Java SDK Facebody	facebody-20200910

• Python

  Open a command prompt and run the following command to install the Python SDK.

  pip install alibabacloud_facebody20200910

• Java sample request

  Note

  Replace <accessKeyId> and <accessSecret> in the code sample with your AccessKey ID and AccessKey Secret. To learn how to obtain an AccessKey, see Create an AccessKey.

  import com.aliyun.facebody20200910.models.ExecuteServerSideVerificationRequest;
  import com.aliyun.facebody20200910.models.ExecuteServerSideVerificationResponse;
  import com.aliyun.teaopenapi.models.Config;
  import com.aliyun.teautil.models.RuntimeOptions;
  import com.google.gson.Gson;
  
  import java.util.HashMap;
  import java.util.Map;
  
  public class TestExecuteServerSideVerification {
  
      public static void main(String[] args) {
          try {
              // To create an AccessKey ID and AccessKey Secret, see https://help.aliyun.com/document_detail/175144.html.
              // If you are using a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
              // The following code reads the AccessKey ID and AccessKey Secret from environment variables. Make sure you have configured them before running the sample.
              com.aliyun.facebody20200910.Client client = createClient(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
              ExecuteServerSideVerificationRequest request = new ExecuteServerSideVerificationRequest();
              request.setCertificateName("Real name");
              request.setCertificateNumber("ID card number");
              request.setFacialPictureUrl("Image URL");
              request.setSceneType("server");
              RuntimeOptions runtime = new RuntimeOptions();
              Map<String, String> headers = new HashMap();
              headers.put("Accept-Encoding", "identity");
              ExecuteServerSideVerificationResponse response = client.executeServerSideVerificationWithOptions(request, headers, runtime);
              System.out.println("ExecuteServerSideVerificationResponse response: " + new Gson().toJson(response));
          } catch (Exception e) {
              e.printStackTrace();
          }
      }
  
      public static com.aliyun.facebody20200910.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
          Config config = new Config();
          // Your AccessKey ID.
          config.accessKeyId = accessKeyId;
          // Your AccessKey Secret.
          config.accessKeySecret = accessKeySecret;
          // The endpoint of the service.
          config.endpoint = "facebody.cn-shanghai.aliyuncs.com";
          return new com.aliyun.facebody20200910.Client(config);
      }
  }

• Python sample request

  Note

  Replace <accessKeyId> and <accessSecret> in the code sample with your AccessKey ID and AccessKey Secret. To learn how to obtain an AccessKey, see Create an AccessKey.

  from alibabacloud_facebody20200910.client import Client
  from alibabacloud_tea_openapi.models import Config
  from alibabacloud_tea_util.models import RuntimeOptions
  
  from alibabacloud_facebody20200910.models import ExecuteServerSideVerificationRequest
  
  config = Config(
          # To create an AccessKey ID and AccessKey Secret, see https://help.aliyun.com/document_detail/175144.html.
          # If you are using a RAM user's AccessKey, you must grant the AliyunVIAPIFullAccess permission to the RAM user. For more information, see https://help.aliyun.com/document_detail/145025.html.
          # The following code reads the AccessKey ID and AccessKey Secret from environment variables. Make sure you have configured them before running the sample.
          access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
          access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
          endpoint='facebody.cn-shanghai.aliyuncs.com',
          region_id='cn-shanghai',
          type='access_key'
      )
  
  # init RuntimeObject
  runtime_option = RuntimeOptions()
  
  # init Client
  client = Client(config)
  
  
  request = ExecuteServerSideVerificationRequest(
      certificate_name="Real name",
      certificate_number="ID card number",
      facial_picture_url="Image URL"
  )
  
  
  response = client.execute_server_side_verification_with_options(request, headers={"Accept-Encoding": "identity"}, runtime=runtime_option)
  
  print(response)

{
    "RequestId": "1638718D-C4BA-4009-845D-AC26CACB8354",
    "Data": {
        "Pass": true,
        "VerificationToken": "f2a6bb31a5a9f04edd68eab08045****",
        "Reason": "Verification passed (Z8120)"
    }
}

This sample response shows a successful verification, where the face in the image matches the provided name and ID number. The fields are described below:

• RequestId: The unique ID of the request.

• Pass: Indicates whether the verification was successful. A value of true means the verification passed.

• VerificationToken: A unique token for the verification request.

• Reason: A message describing the verification result.