Đăng nhập

Ngày cập nhật: 19 tháng 5, 2023
Người cập nhật: VNPT eContract's team

---

Mục đích: Lấy thông tin mã token để truy cập các API yêu cầu xác thực.

• Request URL: api/v2/auth/password-login
• HTTP method: POST
• HTTP content-type: application/json
• Parameter:

Key	Type	Description
username	string	[Bắt buộc] Tên đăng nhập của người dùng
password	string	[Bắt buộc] Mật khẩu đăng nhập tài khoản người dùng

Mẫu request

{
    "username": "congtyABC@email.com",
    "password": "123456"
}

Mẫu response body

{
    "data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9……",
    "success": true,
    "code": 0,
    "messages": [
        "Authenticate and choose company success"
    ]
}

Lưu ý

• Nếu tài khoản chỉ quản lý một công ty, sau khi gọi api này hệ thống sẽ tự động chọn công ty.
• Nếu tài khoản quản lý nhiều công ty, sau khi gọi api này cần gọi thêm api chọn công ty để xác định thao tác xử lý trong công ty nào.

Mã trả về khi dùng token để xác thực

Mã trả về	Ý nghĩa
200 (OK)	Thành công
401 (Unauthorized)	Token sai hoặc hết hạn
502 (Bad Gateway)	Timeout