Gửi Báo cáo Vi phạm
Endpoint cho phép các đối tác gửi báo cáo khách thuê vi phạm lên hệ thống RentID. Hồ sơ sau khi gửi sẽ được tiếp nhận và xử lý theo quy trình kiểm duyệt uy tín.
1. Địa chỉ Endpoint
Lấy danh mục lý do vi phạm:
https://rentid.vn/api/v1/reports/reasons
Tạo mới hồ sơ báo cáo vi phạm:
https://rentid.vn/api/v1/reports
2. Xác thực Header
Tất cả các lệnh gọi API đều yêu cầu truyền khóa API của đối tác qua Header x-api-key.
3. API Lấy Danh mục Lý do Vi phạm (GET)
API trả về danh mục các lý do vi phạm đang kích hoạt trên hệ thống RentID. Đối tác gọi API này để lấy mã id tương ứng truyền vào trường reason_type_id khi tạo báo cáo.
curl -X GET "https://rentid.vn/api/v1/reports/reasons" \
-H "x-api-key: YOUR_PARTNER_API_KEY" \
-H "Accept: application/json"Cấu trúc phản hồi thành công (200 OK):
{
"status": 200,
"success": true,
"message": "Lấy danh mục lý do thành công",
"data": [
{
"id": 2,
"name": "Làm mất giấy tờ , tài sản trên xe , chìa khóa xe",
"description": "Áp dụng khi người thuê làm mất tài sản trên xe nhưng không hợp tác xử lý thiệt hại",
"score_impact": -150
},
{
"id": 4,
"name": "Gây hư hỏng xe do sử dụng sai hướng dẫn",
"description": "Áp dụng khi người thuê gây hư hỏng các thiết bị trong xe do không làm đúng hướng dẫn nhưng không hợp tác xly hậu quả",
"score_impact": -250
}
]
}Danh sách lý do vi phạm hiện có trên hệ thống:
| Tên lý do vi phạm | Mô tả |
|---|---|
| Làm mất giấy tờ , tài sản trên xe , chìa khóa xe | Áp dụng khi người thuê làm mất tài sản trên xe nhưng không hợp tác xử lý thiệt hại |
| Gây hư hỏng xe do sử dụng sai hướng dẫn | Áp dụng khi người thuê gây hư hỏng các thiết bị trong xe do không làm đúng hướng dẫn nhưng không hợp tác xly hậu quả |
| Tự ý giao xe cho người khác lái khi chưa được chủ xe chấp thuận | Tự ý giao xe cho người khác lái vi phạm trong hợp đồng cho thuê xe gây hậu quả đến chủ xe |
| Cố tình che giấu tai nạn hoặc hư hỏng xe | Cố tình che giấu tai nạn hoặc hư hỏng xe sau khi xảy ra tai nạn nhưng không khắc phục Tự ý mang xe đi sửa nhưng không báo lại chủ xe gây thiệt hại cho chủ xe |
| Không hợp tác xử lý phạt nguội | Thuê xe dẫn đến bị phạt nguội nhưng không hợp tác xly phạt nguội . Cố tình trốn tránh trách nhiệm xly phạt nguội |
| Gian lận giấy tờ thuê xe | Cố tình làm giả giấy tờ thuê xe với mục đích xấu |
| Gian lận tài khoản thuê xe | Tạo nhiều tài khoản để né tránh lịch sử tín nhiệm hoặc lệnh khóa |
| Nghi ngờ chiếm đoạt xe / cầm cố xe / lừa đảo | Cung cấp CCCD, GPLX, số điện thoại hoặc thông tin cá nhân có dấu hiệu giả mạo/không trùng khớp. Sử dụng giấy tờ của người khác để thuê xe. Cố tình cung cấp địa chỉ cư trú không chính xác, không xác minh được nơi ở. Thuê xe nhưng không trả đúng thời hạn, liên tục né tránh hoặc viện nhiều lý do bất thường. Mất liên lạc, tắt điện thoại hoặc chặn chủ xe khi đến hạn trả xe. Cố tình ngắt GPS/thiết bị định vị, tháo hoặc can thiệp vào thiết bị giám sát. Đưa xe đến địa điểm bất thường, di chuyển ra khỏi khu vực đã thỏa thuận mà không thông báo. |
| Khác | Các lý do khác chưa được liệt kê |
| Cố tình trốn tránh, không trả tiền thuê xe/sửa xe | — |
| Lừa tiền cọc thuê xe | — |
(*) Trường hợp lý do vi phạm chưa có trong danh mục: chọn mục Khác và truyền kèm trường other_reason để mô tả cụ thể.
4. API Gửi Báo cáo Vi phạm (POST)
Endpoint tiếp nhận hồ sơ báo cáo từ đối tác. Hệ thống hỗ trợ linh hoạt 2 phương thức gửi file đính kèm: truyền mảng liên kết URL hoặc tải trực tiếp file từ máy (Multipart/Form-Data).
curl -X POST "https://rentid.vn/api/v1/reports" \
-H "x-api-key: YOUR_PARTNER_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"subject_name": "Trần Văn Gian",
"subject_phone": "0987654321",
"subject_cccd": "001200001234",
"reason_type_id": 2,
"description": "Thuê xe máy không trả đúng hạn, chặn liên lạc và chiếm đoạt tài sản.",
"images": [
"https://cdn.example.com/hopdong_thuexe.jpg",
"https://cdn.example.com/bienban_bangiao.jpg"
]
}'curl -X POST "https://rentid.vn/api/v1/reports" \
-H "x-api-key: YOUR_PARTNER_API_KEY" \
-H "Accept: application/json" \
-F "subject_name=Trần Văn Gian" \
-F "subject_phone=0987654321" \
-F "subject_cccd=001200001234" \
-F "reason_type_id=2" \
-F "description=Thuê xe máy không trả đúng hạn, chặn liên lạc và chiếm đoạt tài sản." \
-F "images[]=@/duong-dan/hopdong_thuexe.jpg" \
-F "images[]=@/duong-dan/bienban_bangiao.jpg"Tham số Yêu cầu (Body Parameters)
- Các trường thông tin người báo cáo (
reporter_*) là tùy chọn. Khi không truyền, hệ thống sẽ tự động gán tên của Đối tác (bên sở hữu API Key) làm đại diện gửi báo cáo. - Trong trường hợp đứng tên đại diện báo cáo, Đối tác chịu hoàn toàn trách nhiệm pháp lý về tính xác thực, độ chính xác của nội dung và các tài liệu/bằng chứng vi phạm được đăng tải qua API.
| Tham số | Kiểu | Bắt buộc? | Mô tả & Định dạng |
|---|---|---|---|
| subject_name | string | Bắt buộc | Họ và tên đối tượng vi phạm (VD: "Trần Văn A"). |
| subject_gender | string | Tùy chọn | Giới tính đối tượng (VD: "Nam", "Nữ", hoặc "Khác"). |
| subject_cccd | string | 1 trong 3 (*) | Số CCCD hoặc CMND của đối tượng (9 hoặc 12 số). |
| subject_license | string | 1 trong 3 (*) | Số Giấy phép lái xe (GPLX 12 số). |
| subject_passport | string | 1 trong 3 (*) | Số Hộ chiếu (khách nước ngoài hoặc công dân). |
| subject_phone | string | Tùy chọn | Số điện thoại chính của đối tượng (định dạng 10 chữ số VN). |
| subject_email | string | Tùy chọn | Email của đối tượng vi phạm. |
| subject_address | string | Tùy chọn | Địa chỉ cư trú. |
| subject_cccd_image | string / file | Tùy chọn | Ảnh chụp CCCD / CMND của đối tượng (URL ảnh hoặc upload file trực tiếp ≤ 5MB). |
| subject_license_image | string / file | Tùy chọn | Ảnh chụp Giấy phép lái xe (GPLX) của đối tượng (URL ảnh hoặc upload file trực tiếp ≤ 5MB). |
| subject_passport_image | string / file | Tùy chọn | Ảnh chụp Hộ chiếu (Passport) của đối tượng (URL ảnh hoặc upload file trực tiếp ≤ 5MB). |
| reason_type_id | integer | Bắt buộc | ID danh mục lý do vi phạm (lấy từ mục 3: GET /api/v1/reports/reasons). |
| other_reason | string | Tùy chọn | Mô tả lý do cụ thể khi chọn lý do vi phạm là mục "Khác" (tối đa 255 ký tự). |
| description | string | Tùy chọn | Mô tả chi tiết sự việc vi phạm, tổn thất hoặc chứng cứ liên quan. |
| reporter_name | string | Tùy chọn | Tên người trực tiếp lập báo cáo. Nếu để trống, hệ thống tự động gán theo tên của Đối tác. |
| reporter_phone | string | Tùy chọn | Số điện thoại liên hệ của người báo cáo (10 số). |
| reporter_email | string | Tùy chọn | Email của người gửi báo cáo để nhận thông báo tiến trình kiểm duyệt. |
| images | array / files | Bắt buộc (*) | Mảng hình ảnh hoặc tài liệu bằng chứng vi phạm (tối đa 10 ảnh, dung lượng ≤ 5MB/ảnh). Hỗ trợ 2 phương thức: truyền array URL ảnh (JSON) hoặc upload file ảnh trực tiếp (Multipart). |
(*) Thông tin mang tính định danh: Bắt buộc phải cung cấp ít nhất một trong ba thông tin định danh: subject_cccd, subject_license hoặc subject_passport nhằm xác định chính xác đối tượng trên hệ thống và phục vụ tra cứu.
(*) Yêu cầu ảnh bằng chứng: Bắt buộc phải cung cấp ít nhất một hình ảnh hoặc tài liệu bằng chứng (images) khi lý do vi phạm có mức điểm phạt trừ trên 300 điểm. Đối với các lý do có điểm trừ từ 300 điểm trở xuống, trường này là tùy chọn.
Cấu trúc Phản hồi (JSON Response)
201 Created - Báo cáo tiếp nhận thành công
{
"status": 201,
"success": true,
"message": "Tạo báo cáo thành công"
}422 Unprocessable - Lỗi dữ liệu đầu vào (Thiếu định danh hoặc sai định dạng)
{
"status": 422,
"success": false,
"message": "Dữ liệu không hợp lệ.",
"errors": {
"subject_identifier": [
"Vui lòng cung cấp ít nhất một thông tin: CCCD, GPLX hoặc Hộ chiếu của đối tượng."
]
}
}play_circle 5. Thử nghiệm Trực tiếp (Sandbox)
info Mỗi URL trên một dòng hoặc phân cách bởi dấu phẩy. Gửi qua JSON Body, hệ thống tự động tải ảnh về lưu trữ an toàn.
Nhấn để chọn file ảnh hoặc kéo thả vào đây
Hỗ trợ JPG, PNG, WEBP (Tối đa 10 ảnh, dung lượng ≤ 5MB/ảnh)
6. Mã Trạng Thái & Lỗi (HTTP Codes)
Các mã phản hồi chuẩn của API Báo cáo:
| Mã HTTP | Ý nghĩa | Mô tả chi tiết |
|---|---|---|
| 201 Created | Tạo thành công | Báo cáo đã được tiếp nhận thành công vào hàng đợi kiểm duyệt. |
| 200 OK | Thành công | Trả về danh mục lý do vi phạm thành công. |
| 401 Unauthorized | Chưa xác thực | Thiếu header x-api-key hoặc khóa API không tồn tại / đã bị khóa. |
| 422 Unprocessable | Lỗi tham số | Dữ liệu gửi lên không thỏa mãn quy tắc (Ví dụ: Không có định danh CCCD/GPLX/Hộ chiếu, hoặc sai format SĐT). |
| 429 Too Many Requests | Vượt hạn mức | Đối tác gọi API vượt quá tần suất cho phép trong khoảng thời gian quy định. |
