Danh sách tài khoản
API này dùng để lấy thông tin chi tiết về danh sách các tài khoản Simplize của đối tác, bao gồm trạng thái hoạt động và ngày tạo tài khoản.
HTTP request
- URL:
/api/general/v1/partner/users - Method:
GET - Content Type: None
- Response Type: application/json
Tham số header
| Header | Mô tả | Kiểu dữ liệu | Bắt buộc |
|---|---|---|---|
| X-Api-Key | Khóa duy nhất. | string | có |
## Tham Số Truy Vấn (Query Parameters)
| Tên Tham Số | Kiểu Dữ Liệu | Bắt buộc | Mô Tả |
|---|---|---|---|
| page | string | không | Trang dữ liệu cần lấy, default: 0. |
| size | string | không | Số bản ghi của một trang, default: 10. |
| recvWindow | string | không | Thời gian chấp nhận (ms), default: 5000. |
| timestamp | string | có | Unix timestamp (milliseconds). |
| signature | string | có | HMAC-SHA256 signature. |
Phản Hồi (Response)
Response Mẫu
{
"status": 200,
"message": "Success",
"total": 19,
"data": [
{
"id": 26,
"userId": 1425,
"externalUserId": "USER015",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 25,
"userId": 1424,
"externalUserId": "USER010222",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 24,
"userId": 1423,
"externalUserId": "USER0111",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 23,
"userId": 1422,
"externalUserId": "12",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 22,
"userId": 1421,
"externalUserId": "{{externalUserId}}",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 21,
"userId": 1420,
"externalUserId": "1",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 20,
"userId": 1419,
"externalUserId": "USER013",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 19,
"userId": 1418,
"externalUserId": "11",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 18,
"userId": 1417,
"externalUserId": "VIC13",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
},
{
"id": 17,
"userId": 1416,
"externalUserId": "VIC12",
"status": "ACTIVE",
"createdDate": "2025-12-16T04:50:44.513Z"
}
]
}
Chi Tiết Tham Số Response
| Tên Thuộc Tính | Kiểu Dữ Liệu | Mô Tả |
|---|---|---|
| status | number | Mã trạng thái HTTP. |
| message | string | Thông báo kết quả xử lý. |
| total | number | Tổng số bản ghi. |
| data | array (Xem chi tiết) | Dữ liệu chi tiết tài khoản người dùng. |
| Tên Thuộc Tính | Kiểu Dữ Liệu | Mô Tả |
|---|---|---|
| id | number | ID duy nhất của người dùng trên hệ thống Simplize. |
| userId | string | User Id người dùng từ hệ thống của Simplize. |
| externalUserId | string | UserId của đối tác. |
| status | string | Trạng thái tài khoản: - ACTIVE: Hoạt động - INACTIVE: Không hoạt động |
| createdDate | string | Thời gian tạo tài khoản (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'). |