Lấy danh sách vai trò của người dùng

Ngày cập nhật: 17 tháng 3, 2025
Người cập nhật: VNPT eContract's team

---

Mục đích

Hàm thực hiện lấy danh sách vai trò của người dùng ở công ty hiện tại

• Request URL: /api/roles
• HTTP method: GET
• Authorize: Bearer token
• Parameter: Không yêu cầu, tuy nhiên có thể thêm các tùy chọn bên dưới để thực hiện lọc hoặc tìm kiếm danh sách vai trò của người dùng.

Key	Type	Description
search	string	Thông tin tìm kiếm theo mã vai trò hoặc tên vai trò
page	int	Số trang cần lấy dữ liệu (Mặc định hệ thống đang là 1)
pagesize	int	Số record dữ liệu mà hệ thống sẽ trả về sau mỗi request (Mặc định hệ thống đang là 10 record)

Mẫu request

Query param:
    page: 1
    pageSize: 10
    search: Default
Request: /api/roles?page=1&pageSize=10&search=Default

Mẫu response body

{
    "data": {
        "items": [
            {
                "id": "2b999cd0-32ec-4e4a-16b8-08da6df5fc5a",
                "code": "Default",
                "name": "Mặc định",
                "description": "Vai trò mặc định với những quyền cơ bản"
            }
        ],
        "totalCount": 1,
        "pageCount": 1,
        "page": 1,
        "pageSize": 10,
        "hasNextPage": false,
        "hasPreviousPage": false
    },
    "success": true,
    "code": 0,
    "messages": []
}