Đăng ký
Tạo tài khoản người dùng mới.
Note
Lưu ý quan trọng:
- Tham số có gắn nhãn Required là bắt buộc.
- Tham số có gắn nhãn Optional có thể có hoặc không.
- Trường password sẽ được mã hóa trước khi lưu vào cơ sở dữ liệu.
- Sau khi đăng ký thành công, hệ thống sẽ trả về một API Token để người dùng sử dụng cho các request tiếp theo.
Request
POST
/api/register
Headers
application/json
Required
application/json
Required
Body Params
string
Required
Tên đầy đủ người dùng.
string
Required
Email hợp lệ để đăng nhập.
string
Required
Mật khẩu người dùng.
Response
200
{
"status": "success",
"message": "Đăng ký thành công!",
"data": {
"user": {
"id": 1,
"name": "Nguyen Van A",
"email": "a@example.com",
"created_at": "2025-01-01T00:00:00Z"
},
"token": "string"
}
}
Đăng nhập
Xác thực người dùng và lấy API Token.
Note
Lưu ý quan trọng:
- Tham số có gắn nhãn Required là bắt buộc.
- Tham số có gắn nhãn Optional có thể có hoặc không.
- Sử dụng email và password để đăng nhập.
- Nếu thông tin không chính xác, hệ thống trả về lỗi 422.
Request
POST
/api/login
Headers
application/json
Required
application/json
Required
Body Params
string
Required
Email đã đăng ký.
string
Required
Mật khẩu tương ứng.
Response
200
{
"status": "success",
"message": "Đăng nhập thành công!",
"data": {
"user": {
"id": 1,
"name": "Nguyen Van A",
"email": "a@example.com"
},
"token": "string"
}
}
Thông tin người dùng
Lấy thông tin chi tiết của một người dùng theo ID.
Note
Lưu ý quan trọng:
- Tham số có gắn nhãn Required là bắt buộc.
- Tham số có gắn nhãn Optional có thể có hoặc không.
- Yêu cầu Bearer Token trong header Authorization.
- Nếu ID không tồn tại, hệ thống trả về lỗi 404.
Request
GET
/api/profile/{id}
Headers
application/json
Required
Bearer {token}
Required
Headers & URL Params
integer
Required
ID của người dùng cần lấy thông tin.
Response
200
{
"status": "success",
"message": "Lấy thông tin người dùng thành công!",
"data": {
"user": {
"id": 1,
"name": "Nguyen Van A",
"email": "a@example.com",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-01-05T12:00:00Z"
}
}
}
Đăng xuất
Xóa API Token hiện tại, đăng xuất người dùng.
Note
Lưu ý quan trọng:
- Tham số có gắn nhãn Required là bắt buộc.
- Tham số có gắn nhãn Optional có thể có hoặc không.
- Yêu cầu Bearer Token trong header Authorization.
- Sau khi logout, token sẽ không còn hiệu lực.
Request
POST
/api/logout
Headers
application/json
Required
application/json
Required
Bearer {token}
Required
Response
200
{
"status": "success",
"message": "Đăng xuất thành công!",
"data": null
}