HRMNhân viên
Danh sách công ty của tôi
Lấy danh sách các công ty mà tài khoản đang đăng nhập tham gia, kèm thông tin có thể đổi sang hay không.
Endpoint
GET /v1/usersessions/me/companylist
Headers
| Tên | Giá trị | Bắt buộc | Mô tả |
|---|---|---|---|
Authorization | <JWT> | Có | User Login Token. API này không dùng được với API Key. |
Response Schema
HTTP 200 - JSON Object
{
"total": 2,
"current_company_id": 10311,
"items": [
{
"id": 101,
"user_id": 1,
"company": { "id": 10311, "name": "Công ty TNHH Phần Mềm Xanh", "status": 1, ... },
"employee": { "id": 101, "company_id": 10311, "user_id": 1, "status": 1, ... },
"access": "full",
"is_current": true,
"switchable": false
},
{
"id": 205,
"user_id": 1,
"company": { "id": 10500, "name": "Chi nhánh Hà Nội", "status": 1, ... },
"employee": { "id": 205, "company_id": 10500, "user_id": 1, "status": 1, ... },
"access": "full",
"is_current": false,
"switchable": true
}
]
}| Field | Kiểu | Mô tả |
|---|---|---|
total | int | Số công ty |
current_company_id | int | ID công ty của JWT hiện tại |
items[].id | int | Employee ID của tài khoản trong công ty |
items[].user_id | int | User ID |
items[].company | object | Thông tin công ty |
items[].employee | object | Thông tin nhân viên trong công ty |
items[].access | string | (Chỉ có trên Hubport SaaS) full, limited, blocked hoặc restorable, xem Đăng nhập |
items[].is_current | bool | Là công ty đang làm việc |
items[].switchable | bool | Có thể đổi sang công ty này: không phải công ty hiện tại, nhân viên đang hoạt động, công ty đang hoạt động và không bị khoá |
Lưu ý:
- Không bao gồm các công ty mà tài khoản đã bị xoá khỏi danh sách nhân viên.
- Danh sách trả về tối đa 20 công ty.
- API này vẫn gọi được khi công ty hiện tại đang bị khoá.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 403 | error_user_session_required | Request không dùng JWT của người dùng (ví dụ dùng API Key) |