$ npm install
$ npm run dev
- The server listens at port 3001
{
"id": 1,
"name": "User 1",
"email": "[email protected]",
"birthday": "1976-03-13",
"password": "password1"
}
API này cho phép lấy danh sách tất cả người dùng có trong hệ thống.
- Đường dẫn:
/api/users
- Phương thức: GET
GET /api/users
API này cho phép lấy danh sách người dùng từ cơ sở dữ liệu với tính năng phân trang.
- Đường dẫn:
/api/users
- Phương thức: GET
_page
: Xác định số trang cần lấy. Mặc định là 1 nếu không được chỉ định._limit
: Xác định số lượng người dùng tối đa trên mỗi trang. Mặc định là 10 nếu không được chỉ định.
GET /api/users?_page=1&_limit=10
API này cho phép lọc danh sách người dùng theo các tiêu chí nhất định.
- Đường dẫn:
/api/users/filter
- Phương thức: GET
email
(String): email của người dùng cần lấy thông tin.
GET /api/users/[email protected]
API này cho phép lấy thông tin của một người dùng dựa trên ID của họ
- Đường dẫn:
/api/users/:id
- Phương thức: GET
id
(Number): ID của người dùng cần lấy thông tin.
GET /api/users/1
API này cho phép tạo mới một người dùng trong cơ sở dữ liệu.
- Đường dẫn:
/api/users
- Phương thức: POST
- Content-Type: application/json
Các trường dữ liệu cần được cung cấp để tạo người dùng:
name
(String): Tên của người dùng mới.email
(String): Email của người dùng mới.birthday
(String): Ngày sinh của người dùng mới.password
(String): Mật khẩu của người dùng mới.
POST /api/users
Content-Type: application/json
{
"name": "Người dùng mới",
"email": "[email protected]",
"birthday": "1990-01-01",
"password": "newpassword"
}
API này cho phép xoá một người dùng từ cơ sở dữ liệu bằng ID của người dùng.
- Đường dẫn:
/api/users/:id
- Phương thức: DELETE
id
(Number): ID của người dùng cần xoá.
DELETE /api/users/123
API này cho phép cập nhật thông tin của một người dùng đã đăng ký bằng cách sử dụng ID của người dùng.
- Đường dẫn:
/api/users/:id
- Phương thức: PUT
- Content-Type: application/json
id
(Number): ID của người dùng cần cập nhật thông tin.
Các trường dữ liệu có thể được cập nhật:
name
(String): Tên mới của người dùng.email
(String): Email mới của người dùng.birthday
(String): Ngày sinh mới của người dùng.password
(String): Mật khẩu mới của người dùng.
PUT /api/users/123
Content-Type: application/json
{
"name": "Người dùng mới",
"email": "[email protected]",
"birthday": "1990-05-15",
"password": "newpassword"
}
API này cho phép xác thực người dùng bằng cách đăng nhập và trả về thông tin người dùng sau khi đăng nhập thành công.
- Đường dẫn:
/api/login
- Phương thức: POST
- Content-Type: application/json
Tên | Kiểu dữ liệu | Mô tả |
---|---|---|
String | Email của người dùng | |
password | String | Mật khẩu của người dùng |
POST /api/login
Content-Type: application/json
{
"email": "[email protected]",
"password": "password123"
}