Liveness Verify

Thử nghiệm nhanh API:

1. Thực hiện eKYC sử dụng ảnh chụp chân dung người dùng ở 3 góc độ với đầu vào URL ảnh

API:

Params:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
portrait_left = 'link_url_portrait_left'
portrait_mid = 'link_url_portrait_mid'
portrait_right = 'link_url_portrait_right'

response = requests.get("https://cloud.computervision.com.vn/api/v2/ekyc/verify_liveness?portrait_left=%s&portrait_mid=%s&portrait_right=%s&format_type=%s"
  % (portrait_left, portrait_mid, portrait_right, 'url'),
  auth=(api_key, api_secret))

print(response.json())

2. Thực hiện eKYC sử dụng ảnh chụp chân dung người dùng ở 3 góc độ với đầu vào file ảnh

API:

Params:

Body:

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
img1_path = '/path/to/your/example_1.jpg'
img2_path = '/path/to/your/example_2.jpg'
img3_path = '/path/to/your/example_3.jpg'

response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/ekyc/verify_liveness?format_type=file",
    auth=(api_key, api_secret),
    files={ 'portrait_left': open(img1_path, 'rb'),
            'portrait_mid': open(img2_path, 'rb'),
            'portrait_right': open(img3_path, 'rb')
        })

print(response.json())

3. Thực hiện eKYC sử dụng ảnh chụp chân dung người dùng ở 3 góc độ với đầu vào JSON

API:

Params:

Body:

{
  "portrait_left": "iVBORw0KGgoAAAANSU...", // string base64 của ảnh quay trái
  "portrait_mid": "iVBORw0KGgoAAAANSU...", // string base64 của ảnh chính diện
  "portrait_right": "iVBORw0KGgoAAAANSU..." // string base64 của ảnh quay phải
}

Demo Python:

import base64
import io
import requests
from PIL import Image
def get_byte_img(img):
    img_byte_arr = io.BytesIO()
    img.save(img_byte_arr, format='PNG')
    encoded_img = base64.encodebytes(img_byte_arr.getvalue()).decode('ascii')
    return encoded_img
api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
portrait_left_path = '/path/to/your/portrait_left.jpg'
portrait_mid_path = '/path/to/your/portrait_mid.jpg'
portrait_right_path = '/path/to/your/portrait_right.jpg'
encode_portrait_left = get_byte_img(Image.open(portrait_left_path))
encode_portrait_mid = get_byte_img(Image.open(portrait_mid_path))
encode_portrait_right = get_byte_img(Image.open(portrait_right_path))
response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/ekyc/verify_liveness?format_type=base64",
    auth=(api_key, api_secret),
    json={'portrait_left': encode_portrait_left, 'portrait_mid': encode_portrait_mid, 'portrait_right': encode_portrait_right})
print(response.json())

4. Thông tin trả về

Thông tin trả về của API Liveness Verify là một JSON với định dạng sau:

{
  "data": {
    "invalidCode": string, // Mã cảnh báo
    "invalidMessage": string, // Cảnh báo nếu ảnh chân dung hoặc ảnh giấy tờ có dấu hiệu làm ảnh hưởng đến kết quả
    "matching_mid_left": string,
    "matching_mid_right": string,
    "valid": string // (True/False)
  },
  "errorCode": string, // Mã lỗi
  "errorMessage": string // Thông báo lỗi
}

Bảng mã lỗi:

Bảng mã lỗi cảnh báo: