Hồ sơ nhân sự

Thử nghiệm nhanh API:

1. Trích xuất thông tin Hồ sơ nhân sự với đầu vào URL của ảnh hoặc pdf

API:

Method	URL
GET	`https://cloud.computervision.com.vn/api/v2/ocr/employee_profile`

Params:

Key	Value	Mô tả
`img`	`https://example.com/image.png`	URL của ảnh hoặc pdf
`format_type`	`url`	Loại data truyền vào, nhận giá trị: `url`, `file`, `base64`
`get_thumb`	`true`/`false`	Trả về ảnh của Hồ sơ nhân sự đã được căn chỉnh

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

image_url = 'https://example.com/image.png'

response = requests.get(
  "https://cloud.computervision.com.vn/api/v2/ocr/employee_profile?img=%s&format_type=url&get_thumb=false"
  % image_url,
  auth=(api_key, api_secret))

print(response.json())

2. Trích xuất thông tin Hồ sơ nhân sự với đầu vào file ảnh hoặc file pdf

API:

Method	URL	content-type
POST	`https://cloud.computervision.com.vn/api/v2/ocr/employee_profile`	`multipart/form-data`

Params:

Key	Value	Mô tả
`format_type`	`file`	Loại data truyền vào, nhận giá trị: `url`, `file`, `base64`
`get_thumb`	`true`/`false`	Trả về ảnh của Hồ sơ nhân sự đã được căn chỉnh

Body:

Key	Type	Value	Mô tả
`img`	`file`	`example.jpg`	File ảnh hoặc pdf của Hồ sơ nhân sự

Demo Python:

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
image_path = '/path/to/your/image.jpg'

response = requests.post(
  "https://cloud.computervision.com.vn/api/v2/ocr/employee_profile?format_type=file&get_thumb=false",
  auth=(api_key, api_secret),
  files={'img': open(image_path, 'rb')})

print(response.json())

3. Trích xuất thông tin Hồ sơ nhân sự với đầu vào JSON

API:

Method	URL	content-type
POST	`https://cloud.computervision.com.vn/api/v2/ocr/employee_profile`	`application/json`

Params:

Key	Value	Mô tả
`format_type`	`base64`	Loại data truyền vào, nhận giá trị: `url`, `file`, `base64`
`get_thumb`	`true`/`false`	Trả về ảnh của Hồ sơ nhân sự đã được căn chỉnh

Body:

{
  "img": "iVBORw0KGgoAAAANSU..." // string base64 của ảnh hoặc pdf cần trích xuất
}

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"
img_name = "path_img"
encode_cmt = get_byte_img(Image.open(img_name))
response = requests.post(
    "https://cloud.computervision.com.vn/api/v2/ocr/employee_profile?format_type=base64&get_thumb=false",
    auth=(api_key, api_secret),
    json={'img' : encode_cmt})
print(response.json())

4. Thông tin trả về

Phản hồi sẽ là một JSON với định dạng sau:

{
  "data": [xxxx],
  "errorCode": string, // Mã lỗi.
  "errorMessage": string // Thông báo lỗi.
}

Trong đó trường data là 1 JSON có định dạng như sau:

{
    "id_card": [xxx],
    "registration_book": [xxx],
    "curriculum_vitae": [xxx],
    "academic_degree": [xxx],
    "birth_certificate": [xxx],
    "health_certification": [xxx],
    "confirm_residence": [xxx],
    "image_negative": [xxx],
    "id_negative": [xxx]
}

Chi tiết các trường được mô tả dưới đây:

Đối với các keys id_card, academic_degree, birth_certificate thì value là mảng có một hoặc nhiều phần tử.

Đối với các keys registration_book, curriculum_vitae thì value là mảng có duy nhất một phần tử.

Đối với image_negative là mảng ảnh không trích xuất được bất cứ thông tin của một loại giấy tờ nào (ảnh định dạng base64).

Mỗi phần tử trong mảng sẽ là một JSON với định dạng sau:

{
  "type": string,
  "info": object
}

Thẻ, giấy tờ tùy thân:

Đối với giấy tờ tùy thân thì tương ứng với trường id_card trong data. Trả ra là một list, mỗi phần tử trong list tương ứng với một giấy tờ tùy thân trích xuất được (một giấy tờ tùy thân có thể gồm cả mặt trước và mặt sau). Mỗi phần tử này là một JSON có định dạng như sau:

{
    "type": "id_card", // Thể hiện loại giấy tờ này là giấy tờ tùy thân
    "info": [xxx]
}