Đăng nhập

Ngày cập nhật: 30 tháng 4, 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/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
companyId	int	[Bắt buộc] Id của công ty cần đăng nhập

Lưu ý

Nếu chưa có Id công ty cần đăng nhập, gọi hàm này và bỏ qua tham số companyId để lấy access token, sau đó gọi hàm lấy danh sách công ty và cuối cùng gọi lại hàm này với tham số companyId của công ty cần đăng nhập và thao tác.

i18n\vi\docusaurus-plugin-content-docs\version-1.0.0\api\v1\details\authentications\get-companies.md

Mẫu request

{
    "username": "username.demo@email.com",
    "password": "123456&abcdef",
    "companyId": 668
}

Mẫu response body

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

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