Partner API Module: EAgentTraffic

Module cung cấp các API xác thực tài khoản đối tác tra cứu thông tin giao thông (EAgentTraffic). Hệ thống hỗ trợ quy trình đăng nhập và xác thực tài khoản đối tác thông qua mã OTP thật gửi về SMS, mã bảo mật Passcode/PIN hoặc phương thức xác thực hai yếu tố (2FA).

Quay về trang chủ | Mở bản Markdown module

Danh sách API

Thông tin giả lập (Mock Data & Test Cases)

Dữ liệu giả lập phục vụ kiểm thử tích hợp API (sandbox / test environment). Giúp đối tác kiểm thử các kịch bản thành công và lỗi mô phỏng mà không cần tài khoản thực tế.

📄 Tài liệu chi tiết Google Docs: EAgentTraffic – Mock Data & Test Cases (Google Docs)

1. Yêu cầu đăng nhập bằng OTP (requestLoginByOTP)

Username / CCCD Kịch bản Kết quả giả lập
001200000001 Gửi OTP thành công Thành công – trả về token giả lập và thông báo mã OTP đã được gửi.
999000000001 Tên đăng nhập không hợp lệ Thất bại – INVALID_USERNAME.
999000000002 Không được xác thực Thất bại – AGENTETRAFFIC_UNAUTHORIZED.
999000000003 Lỗi gửi yêu cầu OTP Thất bại – AGENTETRAFFIC_OTP_REQUEST_ERROR.
999000000004 Vượt hạn mức tra cứu Thất bại – AGENT_QUOTA_EXCEEDED.

2. Yêu cầu đăng nhập bằng 2FA (requestLoginBy2FA)

Username / CCCD Kịch bản Kết quả giả lập
001200000001 Yêu cầu 2FA thành công Thành công – success = true, requireOtp = true, có session giả lập.
999000000005 Xác thực thất bại Thất bại – AGENTETRAFFIC_AUTHENTICATION_FAILED.

3. Xác nhận OTP (confirmOTP)

OTP Kịch bản Kết quả giả lập
123456 OTP hợp lệ Thành công – success = true; trả về token giả lập và thông tin người dùng mẫu.
000000 OTP không chính xác Thất bại – INCORRECT_OTP.
999999 Lỗi xác nhận OTP Thất bại – AGENTETRAFFIC_CONFIRM_OTP_FAILED.

4. Xác nhận Passcode (confirmPasscode)

Passcode Kịch bản Kết quả giả lập
123456 Passcode hợp lệ Thành công – success = true; trả về token giả lập và thông tin người dùng mẫu.
000000 Passcode không chính xác Thất bại – INCORRECT_PASSWORD.
999999 Lỗi xác nhận Passcode Thất bại – AGENTETRAFFIC_CONFIRM_PASSCODE_FAILED.

Dữ liệu và Lưu ý quan trọng cho Developer

Lưu ý phân biệt môi trường:
  • Môi trường Test / Sandbox (Mock): Có thể sử dụng các bộ dữ liệu mẫu (CCCD/Username, OTP, Passcode) được mô tả trong mục thông tin giả lập phía trên hoặc xem tài liệu Google Docs để kiểm thử tích hợp đầy đủ các kịch bản thành công và lỗi.
  • Môi trường Thật (Production): Hệ thống kết nối trực tiếp đến cổng dịch vụ xác thực giao thông bên thứ ba, do đó trường username (số CCCD/CMND) và otp (mã OTP qua SMS) / passcode bắt buộc phải là dữ liệu thật của tài khoản đối tác.
  • Sau khi xác thực thành công (qua OTP hoặc Passcode), API sẽ trả về token (JWT Token) của phiên làm việc.