API Đồng hồ nước (1.0.0)

Download OpenAPI specification:

Hỗ trợ DeepVision: support@eov.solutions

API xử lý ảnh đồng hồ nước để đọc chỉ số, nhận dạng nhãn hiệu và đánh giá tình trạng đồng hồ, hỗ trợ xử lý cả ảnh đơn và ảnh hàng loạt. Đối với các điểm cuối xử lý hàng loạt (/v2/bulk-*), kết quả được gửi không đồng bộ đến hook_url được cung cấp trong phần thân yêu cầu. Phản hồi webhook tuân theo các lược đồ BulkMeterReadingHookOutput, BulkMeterInspectionHookOutput, hoặc BulkMeterInfoHookOutput như được định nghĩa trong components/schemas. Đảm bảo hook_url là một điểm cuối hợp lệ có thể nhận các yêu cầu POST và trả về mã trạng thái 200.

Xử lý ảnh đơn

Đọc chỉ số đồng hồ từ một ảnh

Xử lý một ảnh để trích xuất chỉ số đồng hồ nước.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

imagename required	string Tên của tệp ảnh.
number_actual	string Chỉ số đồng hồ thực tế do người dùng cung cấp (tùy chọn).
imagedata required	string Dữ liệu ảnh được mã hóa Base64 (JPG, PNG, v.v.).

Responses

Request samples

Payload

Content type

application/json

{"imagename": "example",
"number_actual": "3306",
"imagedata": "<Base64_image>"
}

Response samples

200
400
500

Content type

application/json

{"id": "16021133502",
"imagename": "example",
"actual_number": "3306",
"predicted_number": "809",
"read_number": "0809",
"number_count": 4,
"score": 0.29,
"confidence": 1,
"frame_count": 1,
"frame_data": "https://example.com/images/index_area_image.jpg",
"frame_shape": [[394.96929931640625,
236.75384521484375
],
[425.00006103515625,
233
],
[436.03082275390625,
321.24615478515625
],
[406.00006103515625,
325
]
],
"images": {"full_meter_image": "https://example.com/images/image.jpg",
"index_area_image": "https://example.com/images/index_area_image.jpg"
}
}

Nhận dạng nhãn hiệu và số sê-ri của đồng hồ từ một ảnh

Trích xuất nhãn hiệu và số sê-ri của đồng hồ nước từ một ảnh.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

imagename required	string Tên của tệp ảnh.
imagedata required	string Dữ liệu ảnh được mã hóa Base64 (JPG, PNG, v.v.).

Responses

Request samples

Payload

Content type

application/json

{"imagename": "example",
"imagedata": "<Base64_image>"
}

Response samples

200
400
500

Content type

application/json

{"id": "16021133502",
"imagename": "16021133502",
"meter_type": "P-MAX",
"serial_number": "P-M_D4721502355",
"images": {"full_meter_image": "https://example.com/images/image.jpg"
}
}

Kiểm tra tình trạng đồng hồ từ một ảnh

Đánh giá tình trạng của đồng hồ nước từ một ảnh.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

imagename required	string Tên của tệp ảnh.
imagedata required	string Dữ liệu ảnh được mã hóa Base64 (JPG, PNG, v.v.).

Responses

Request samples

Payload

Content type

application/json

{"imagename": "example",
"imagedata": "<Base64_image>"
}

Response samples

200
400
500

Content type

application/json

{"id": "16021133502",
"imagename": "16021133502",
"meter_condition": {"status": "bad",
"issues_detected": ["ban"
]
},
"images": {"full_meter_image": "https://example.com/images/image.jpg"
}
}

Kiểm tra loại, chỉ số và tình trạng đồng hồ từ một ảnh

Lấy thông tin về loại, chỉ số và tình trạng đồng hồ từ một ảnh.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

imagename required	string Tên của tệp ảnh.
number_actual	string Chỉ số đồng hồ thực tế do người dùng cung cấp (tùy chọn).
imagedata required	string Dữ liệu ảnh được mã hóa Base64 (JPG, PNG, v.v.).

Responses

Request samples

Payload

Content type

application/json

{"imagename": "example",
"number_actual": "3306",
"imagedata": "<Base64_image>"
}

Response samples

200
400
500

Content type

application/json

{"id": "16021133502",
"imagename": "16021133502",
"meter_type": "P-MAX",
"serial_number": "P-M_D4721502355",
"meter_condition": {"status": "bad",
"issues_detected": ["ban"
]
},
"images": {"full_meter_image": "https://example.com/images/image.jpg"
}
}

Lấy thông tin toàn diện về đồng hồ từ một ảnh

Trích xuất loại, chỉ số và tình trạng đồng hồ từ một ảnh.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

imagename required	string Tên của tệp ảnh.
number_actual	string Chỉ số đồng hồ thực tế do người dùng cung cấp (tùy chọn).
imagedata required	string Dữ liệu ảnh được mã hóa Base64 (JPG, PNG, v.v.).

Responses

Request samples

Payload

Content type

application/json

{"imagename": "example",
"number_actual": "3306",
"imagedata": "<Base64_image>"
}

Response samples

200
400
500

Content type

application/json

{"id": "16021133502",
"imagename": "16021133502",
"actual_number": "3306",
"predicted_number": "809",
"read_number": "0809",
"number_count": 4,
"score": 0.29,
"confidence": 1,
"frame_count": 1,
"frame_data": "https://example.com/images/index_area_image.jpg",
"frame_shape": [[394.96929931640625,
236.75384521484375
],
[425.00006103515625,
233
],
[436.03082275390625,
321.24615478515625
],
[406.00006103515625,
325
]
],
"meter_type": "Elster DN20",
"serial_number": "P-M_D4721502355",
"meter_condition": {"status": "Good",
"issues_detected": [ ]
},
"images": {"full_meter_image": "https://example.com/images/full_meter_image.jpg",
"index_area_image": "https://example.com/images/index_area_image.jpg"
}
}

Xử lý ảnh hàng loạt

Đọc chỉ số đồng hồ từ một lô ảnh tải lên

Xử lý một tệp ZIP chứa nhiều ảnh để trích xuất chỉ số đồng hồ, với kết quả được gửi đến một URL webhook.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

data_url required	string <uri> URL của tệp ZIP chứa ảnh.
hook_url required	string <uri> URL Webhook để nhận kết quả xử lý.

Responses

Request samples

Payload

Content type

application/json

{"data_url": "https://example.com/input/example.zip",
"hook_url": "https://example.com/hook_url"
}

Response samples

200
400
500

Content type

application/json

{"id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"status": "processing",
"data_url": "https://example.com/input/example.zip",
"result": { }
}

Kiểm tra danh tính đồng hồ từ một lô ảnh tải lên

Đánh giá danh tính của nhiều đồng hồ nước từ một tệp ZIP, với kết quả được gửi đến một URL webhook.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

data_url required	string <uri> URL của tệp ZIP chứa ảnh.
hook_url required	string <uri> URL Webhook để nhận kết quả xử lý.

Responses

Request samples

Payload

Content type

application/json

{"data_url": "https://example.com/input/example.zip",
"hook_url": "https://example.com/hook_url"
}

Response samples

200
400
500

Content type

application/json

{"id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"status": "processing",
"data_url": "https://example.com/input/example.zip",
"result": { }
}

Trích xuất tình trạng toàn diện của đồng hồ từ một lô ảnh tải lên

Lấy thông tin về loại, chỉ số và tình trạng đồng hồ từ một tệp ZIP, với kết quả được gửi đến một URL webhook.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

data_url required	string <uri> URL của tệp ZIP chứa ảnh.
hook_url required	string <uri> URL Webhook để nhận kết quả xử lý.

Responses

Request samples

Payload

Content type

application/json

{"data_url": "https://example.com/input/example.zip",
"hook_url": "https://example.com/hook_url"
}

Response samples

200
400
500

Content type

application/json

{"id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"status": "processing",
"data_url": "https://example.com/input/example.zip",
"result": { }
}

Kiểm tra loại, chỉ số và tình trạng đồng hồ từ một lô ảnh tải lên

Xử lý một tệp ZIP chứa nhiều ảnh để trích xuất loại, chỉ số và tình trạng đồng hồ, với kết quả được gửi đến một URL webhook.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

data_url required	string <uri> URL của tệp ZIP chứa ảnh.
hook_url required	string <uri> URL Webhook để nhận kết quả xử lý.

Responses

Request samples

Payload

Content type

application/json

{"data_url": "https://example.com/input/example.zip",
"hook_url": "https://example.com/hook_url"
}

Response samples

200
400
500

Content type

application/json

{"id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"status": "processing",
"data_url": "https://example.com/input/example.zip",
"result": { }
}

Lấy thông tin toàn diện về đồng hồ từ một lô ảnh tải lên

Xử lý một tệp ZIP chứa nhiều ảnh để trích xuất loại, chỉ số và tình trạng đồng hồ, với kết quả được gửi đến một URL webhook.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Request Body schema: application/json
required

data_url required	string <uri> URL của tệp ZIP chứa ảnh.
hook_url required	string <uri> URL Webhook để nhận kết quả xử lý.

Responses

Request samples

Payload

Content type

application/json

{"data_url": "https://example.com/input/example.zip",
"hook_url": "https://example.com/hook_url"
}

Response samples

200
400
500

Content type

application/json

{"id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"status": "processing",
"data_url": "https://example.com/input/example.zip",
"result": { }
}

Lấy kết quả xử lý hàng loạt

Lấy kết quả của một công việc xử lý hàng loạt bằng ID của nó, nếu có.

Authorizations:

apiKey

path Parameters

bulkId

required

string <uuid>

Example: 57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68

ID của công việc xử lý hàng loạt

query Parameters

token

required

string

Mã thông báo xác thực API

Responses

Response samples

200
404
500

Content type

application/json

Example

BulkMeterReadingHookOutput

{"bulk_id": "57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68",
"processing_unit": "string",
"result": [{"id": "16021133502",
"imagename": "example",
"actual_number": "3306",
"predicted_number": "809",
"read_number": "0809",
"number_count": 4,
"score": 0.29,
"confidence": 1,
"frame_count": 1,
"frame_data": "https://example.com/images/index_area_image.jpg",
"frame_shape": [[394.96929931640625,
236.75384521484375
],
[425.00006103515625,
233
],
[436.03082275390625,
321.24615478515625
],
[406.00006103515625,
325
]
],
"images": {"full_meter_image": "https://example.com/images/image.jpg",
"index_area_image": "https://example.com/images/index_area_image.jpg"
}
}
]
}

Kiểm tra trạng thái của một tác vụ

Kiểm tra trạng thái của một tác vụ bằng ID của nó.

Authorizations:

apiKey

path Parameters

taskID

required

string <uuid>

Example: 57533ab2-e6fd-4dc8-9ec5-0d71f9c71d68

ID của tác vụ để kiểm tra trạng thái

query Parameters

token

required

string

Mã thông báo xác thực API

Responses

Response samples

200
404
500

Content type

application/json

{"status": "completed"
}

Xem một ảnh

Lấy một ảnh bằng đường dẫn tệp của nó.

Authorizations:

apiKey

path Parameters

file_path

required

string

Đường dẫn đến tệp ảnh

query Parameters

token

required

string

Mã thông báo xác thực API

Responses

Response samples

200
404
500

Content type

application/json

{"image": "string"
}

Kiểm tra giới hạn sử dụng API

Kiểm tra giới hạn sử dụng API hiện tại cho người dùng đã xác thực.

Authorizations:

apiKey

query Parameters

token

required

string

Mã thông báo xác thực API

Responses

Response samples

200
401
500

Content type

application/json

{"limit": 1000,
"remaining": 500
}

Lấy phản hồi đọc hàng loạt

Lấy phản hồi cho một yêu cầu đọc hàng loạt.

Authorizations:

apiKey

query Parameters

requestId required	string ID của yêu cầu đọc hàng loạt
token required	string Mã thông báo xác thực API

Responses

Response samples

200
404
500

Content type

application/json

{"data": [{"id": "string",
"content": "string"
}
]
}

API Đồng hồ nước (1.0.0)

Xử lý ảnh đơn

Đọc chỉ số đồng hồ từ một ảnh

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Nhận dạng nhãn hiệu và số sê-ri của đồng hồ từ một ảnh

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Kiểm tra tình trạng đồng hồ từ một ảnh

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Kiểm tra loại, chỉ số và tình trạng đồng hồ từ một ảnh

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Lấy thông tin toàn diện về đồng hồ từ một ảnh

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Xử lý ảnh hàng loạt

Đọc chỉ số đồng hồ từ một lô ảnh tải lên

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Kiểm tra danh tính đồng hồ từ một lô ảnh tải lên

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Trích xuất tình trạng toàn diện của đồng hồ từ một lô ảnh tải lên

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Kiểm tra loại, chỉ số và tình trạng đồng hồ từ một lô ảnh tải lên

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Lấy thông tin toàn diện về đồng hồ từ một lô ảnh tải lên

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Lấy kết quả xử lý hàng loạt

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Kiểm tra trạng thái của một tác vụ

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required