Thông số

Yêu cầu

Mô hình API

Theo chuẩn RESTful API (mô hình tại Hình 5 - Mô hình RESTful API), hỗ trợ kiểu dữ liệu JSON.

- Đây là phiên bản đầu tiên. Khi hệ thống triển khai thì Cục ĐBVN sẽ có những cập nhật bổ sung và thông báo trên trang chủ tại đường link : https://benxe.gov.vn/doc

- Các hàm truyền dữ liệu có thể được bổ sung một số trường dữ liêu tuy nhiên không làm thay đổi các trường dữ liệu đã có.

- Khi có các cập nhật thì nhóm kĩ thuật trung tâm dữ liệu sẽ gửi mail thông tin về sự thay đổi  thời gian áp dụng đến từng Đơn vị truyền dữ liệu.

- Đơn vị truyền dữ liệu có trách nhiệm theo dõi, giám sát, bổ sung các cập nhật kịp thời.

- Kĩ thuật truyền dẫn và vấn đề an toàn thông tin luôn thay đổi. Vì vậy giao thức này sẽ liên tục bổ sung những cách truyền mới. Đơn vị truyền dữ liệu tùy thuộc vào năng lực công nghệ có thể lựa chọn các giao thức khác nhau. Khuyến khích sử dụng những giao thức mới để đảm bảo hiệu năng cho các bên truyền và bên nhận. Phần nhận dữ liệu luôn đảm bảo hỗ trợ cùng lúc nhiều giao thức.

Thông tin server

https://benxe.gov.vn

Quy định

Thông tin, dữ liệu cung cấp đảm bảo tuân thủ theo quy định tại khoản 8 Điều 4 của Nghị định 10/2020/NĐ-CP; Điều 50 và Điều 51 của Thông tư 12/2020/TT-BGTVT.

Thông tin, dữ liệu cung cấp phải bảo đảm kịp thời, chính xác, đầy đủ, không được sửa chữa hoặc làm sai lệch dữ liệu trước, trong hoặc sau khi truyền dữ liệu.

Giao thức truyền

Giao thức kết nối HTTPS sử dụng chứng chỉ TLS (tham khảo quy định tại Tiêu chuẩn cơ sở TCCS 01:2020/CATTT Cục ATTT- Bộ Thông tin truyền thông công bố ngày 31/10/2020).

Định dạng dữ liệu gửi đi

Dữ liệu gửi lên server là định dạng JSON.

Thêm header: Content-Type: application/json.

Định dạng dữ liệu nhận về

Để nhận về dữ liệu dạng JSON.

Thêm header: Accept: application/json.

Tiêu chuẩn dữ liệu

Hệ thống hỗ trợ dữ liệu chuẩn Unicode (UTF-8).

Tiêu chuẩn thời gian

Sử dụng chuẩn UNIX time (Giờ UTC): Thời gian Unix được định nghĩa bằng số giây kể từ 00:00:00 theo giờ Phối hợp Quốc tế (UTC) ngày 1 tháng 1 năm 1970, trừ đi giây nhuận. Tính đến mili giây.

Bảo mật

- Giao thức truyền sử dụng HTTPS.

- Đăng nhập và phân quyền sử dụng JWT.

- Chỉ cấp tài khoản truyền dữ liệu cho một số IP do Đơn vị truyền dữ liệu đã đăng ký trước với Cục ĐBVN để đảm bảo tính bảo mật của hệ thống.

Xác thực dữ liệu

Xác thực dữ liệu thông qua chữ ký số

Để đảm bảo tính đúng đắn dữ liệu và an toàn thông tin truyền dẫn.

Độ trễ cho phép cho việc truyền dữ liệu

Tối đa 03 phút theo quy định tại Thông tư 12/2020/TT-BGTVT.

Đối với trường thời gian trong bản tin gửi đến máy chủ của Cục ĐBVN, nếu thời gian này quá 15 phút thì hệ thống sẽ cảnh báo lỗi thời gian đối với các bản tin này.

Trường hợp bị gián đoạn đường truyền hoặc có sự cố thực hiện việc truyền lại theo hướng dẫn tại Mục 2.3.2.

Kích thước tối đa

02 MB.

Đây là kích thước tối đa của một ảnh mà máy chủ Cục ĐBVN ghi nhận là tệp có kích thước hợp lệ. Trường hợp ảnh có kích thước lớn hơn, Đơn vị truyền dữ liệu thực hiện thay đổi hệ số nén để đảm bảo ảnh có kích thước < 02MB trước khi truyền dữ liệu

Định dạng biển số xe

Biển số đăng ký xe (biển kiểm soát xe): viết liền, không phân biệt chữ hoa, chữ thường. Ví dụ: 30E00555, 30E-12345.

Định dạng tọa độ

Vị trí (Tọa độ): Decimal Degree, WGS84 (kinh độ, vĩ độ).

Đồng bộ thời gian theo chuẩn NTP

Theo quy định tại khoản 5 Điều 9 Thông tư 12/2020/TT-BGTVT. Đơn vị truyền dữ liệu thông báo đến Tổng cục ĐBVN về việc đã thực hiện xác thực, đồng bộ thời gian chuẩn quốc gia NTP đối với các máy chủ tham gia truyền dẫn dữ liệu trước khi thực hiện.

Truyền theo danh sách

Dung lượng trong một phiên truyền tối đa 10MB.

Mã phản hồi