Sao kê ngân hàng

Thử nghiệm nhanh API:Run in Postman

1. Trích xuất thông tin Sao kê ngân hàng với đầu vào URL của ảnh hoặc pdf

API:

MethodURL
GEThttps://cloud.computervision.com.vn/api/v2/ocr/document/bank_statement

Params:

KeyValueMô tả
imghttps://example.com/image.pngURL của ảnh hoặc pdf
format_typeurlLoại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Sao kê ngân hàng đã đượ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/document/bank_statement?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 Sao kê ngân hàng với đầu vào file ảnh hoặc file pdf

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/ocr/document/bank_statementmultipart/form-data

Params:

KeyValueMô tả
format_typefileLoại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Sao kê ngân hàng đã được căn chỉnh

Body:

KeyTypeValueMô tả
imgfileexample.jpgFile ảnh hoặc pdf của Sao kê ngân hàng

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/document/bank_statement?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 Sao kê ngân hàng với đầu vào JSON

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/ocr/document/bank_statementapplication/json

Params:

KeyValueMô tả
format_typebase64Loại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Sao kê ngân hàng đã đượ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/document/bank_statement?format_type=base64&get_thumb=false",
auth=(api_key, api_secret),
json={'img' : encode_cmt})
print(response.json())

4. Thông tin trả về

Thông tin trả về là một JSON với định dạng sau:

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

Mỗi phần tử trong mảng data (tương ứng với từng trang được trích xuất) sẽ là một JSON với định dạng sau:

{
"image_table": array, // Danh sách ảnh của bảng trong trang
"json": array // Danh sách thông tin tương ứng với từng ảnh trong image_table
}

Mỗi phần tử trong mảng json có cấu trúc như sau:

[
[json_0, json_1, json_2, json_3, json_4], // Biểu thị từng row
[...],
...
]

Trong đó:

  • json_0: Thông tin trường Ngày.
  • json_1: Thông tin trường Mô tả.
  • json_2: Thông tin trường Nợ.
  • json_3: Thông tin trường Có.
  • json_4: Thông tin trường Số dư.

Mỗi JSON này có cấu trúc như sau:

{
"value": // Giá trị text trong ô
"score": // Độ tin cậy
"box": // Ví trí của ô trong bảng
}

Bảng mã lỗi:

Mã lỗiMessageMô tả
0SuccessThành công
1Incorrect image formatẢnh bị lỗi
2Url is unavailableLink ảnh bị lỗi
3Incorrect image formatUpload ảnh bị lỗi khi dùng POST
4Incorrect api_key or api_secretapi_key hoặc api_secret sai
5Out of requestsHết số lượng requests hữu dụng
6Error when processing the requestLỗi khi xử lý request