Báo giá xe

Thử nghiệm nhanh API:Run in Postman

1. Trích xuất thông tin Báo giá xe với đầu vào URL ảnh

API:

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

Params:

KeyValueMô tả
imghttps://example.com/image.pngURL của ảnh
format_typeurlLoại data truyền vào, nhận giá trị: url, file, base64
get_thumbtrue/falseTrả về ảnh của Báo giá xe đã đượ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/price_quotation?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 Báo giá xe với đầu vào file ảnh

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/ocr/document/price_quotationmultipart/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 Báo giá xe đã được căn chỉnh

Body:

KeyTypeValueMô tả
imgfileexample.jpgFile ảnh của Báo giá xe cần trích xuất thông tin

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/price_quotation?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 Báo giá xe với đầu vào JSON

API:

MethodURLcontent-type
POSThttps://cloud.computervision.com.vn/api/v2/ocr/document/price_quotationapplication/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 Báo giá xe đã được xoay và 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/price_quotation?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à một list, mỗi phần tử trong list tương ứng với một báo giá xe (một báo giá xe có thể là một hoặc nhiều trang). Mỗi phần tử này là một JSON định dạng như sau:

{
"type": "price_quotation", // Thể hiện loại giấy tờ ở đây là báo giá
"info": [xxxx]
}

Trong đó trường info thể hiện thông tin trích xuất được từ báo giá. Trường info là một JSON có các trường như sau:

  • estimated_delivery_date: Ngày dự kiến giao xe.
  • estimated_delivery_date_box: Tọa độ ngày dự kiến giao xe là một list gồm [left, top, right, bottom].
  • estimated_delivery_date_confidence: Độ tin cậy của ngày dự kiến giao xe.
  • image: Ảnh của báo giá đã được căn chỉnh, định dạng base64.
  • image_table: Ảnh của bảng trong báo giá đã được căn chỉnh, định dạng base64.
  • make_model: Loại xe.
  • make_model_box: Tọa độ loại xe là một list gồm [left, top, right, bottom].
  • make_model_confidence: Độ tin cậy của loại xe.
  • name_of_garage: Cơ sở sửa chữa.
  • name_of_garage_box: Tọa độ cơ sở sửa chữa là một list gồm [left, top, right, bottom].
  • name_of_garage_confidence: Độ tin cậy của cơ sở sửa chữa.
  • number_plate: Biển số xe.
  • number_plate_box: Tọa độ biển số xe là một list gồm [left, top, right, bottom].
  • number_plate_confidence: Độ tin cậy của biển số xe.
  • quotation_date: Ngày báo giá.
  • quotation_date_box: Tọa độ ngày báo giá là một list gồm [left, top, right, bottom].
  • quotation_date_confidence: Độ tin cậy của ngày báo giá.
  • sub_total: Tổng tiền sửa chữa trước thuế.
  • sub_total_box: Tọa độ tổng tiền sửa chữa trước thuế là một list gồm [left, top, right, bottom].
  • sub_total_confidence: Độ tin cậy của tổng tiền sửa chữa trước thuế.
  • table: Chứa thông tin trích xuất từ bảng. Là một list, mỗi phần tử trong list chứa thông tin của một hàng. Mỗi phần tử này là một JSON chứa các thông tin sau:
    • amount_total: Thành tiền.
    • amount_total_box: Tọa độ phần thành tiền là một list gồm [left, top, right, bottom].
    • amount_total_confidence: Độ tin cậy của thành tiền.
    • description: Tên phụ tùng, dịch vụ sửa chữa.
    • description_box: Tọa độ tên phụ tùng, dịch vụ sửa chữa là một list gồm [left, top, right, bottom].
    • description_confidence: Độ tin cậy của tên phụ tùng, dịch vụ sửa chữa.
    • discount: Số tiền giảm giá.
    • discount_box: Tọa độ số tiền giảm giá là một list gồm [left, top, right, bottom].
    • discount_confidence: Độ tin cậy của số tiền giảm giá.
    • percent_discount: Phần trăm giảm giá.
    • percent_discount_box: Tọa độ phần trăm giảm giá là một list gồm [left, top, right, bottom].
    • percent_discount_confidence: Độ tin cậy của phần trăm giảm giá.
    • quantity: Số lượng.
    • quantity_box: Tọa độ số lượng là một list gồm [left, top, right, bottom].
    • quantity_confidence: Độ tin cậy của số lượng.
    • tax: Phần trăm thuế.
    • tax_box: Tọa độ phần trăm thuế là một list gồm [left, top, right, bottom].
    • tax_confidence: Độ tin cậy của phần trăm thuế.
    • unit_price: Đơn giá.
    • unit_price_box: Tọa độ đơn giá là một list gồm [left, top, right, bottom].
    • unit_price_confidence: Độ tin cậy của đơn giá.
  • total_amount: Tổng tiền sửa chữa sau thuế.
  • total_amount_box: Tọa độ tổng tiền sửa chữa sau thuế là một list gồm [left, top, right, bottom].
  • total_amount_confidence: Độ tin cậy của tổng tiền sửa chữa sau thuế.
  • vat_amount: Tiền thuế.
  • vat_amount_box: Tọa độ tiền thuế là một list gồm [left, top, right, bottom].
  • vat_amount_confidence: Độ tin cậy của tiền thuế.

Bảng mã lỗi:

Mã lỗiMessageMô tả
0SuccessTrích xuất thông tin thành công
1The photo does not contain contentẢnh đầu vào không có nội dung cần trích xuất
2Url is unavailableDownload ảnh bị lỗi khi dùng GET
3Incorrect image formatUpload ảnh bị lỗi khi dùng POST
4Out of requestsHết số lượng request
5Incorrect api_key or api_secretKhi api_key hoặc api_secret sai
6Incorrect format typeLoại format khai báo trong format_type không đúng với ảnh truyền vào