6. Networking
Networking
Promise là gì?
Many web / mobile apps need to load resources from a remote URL. You may want to make a POST request to a REST API, or you may need to fetch a chunk of static content from another server.
Fetch API
Making GET requests
const url = 'https://server.aptech.io/online-shop/products';
fetch(url)
.then((response) => response.json())
.then((json) => {
// Xử lý kết quả JSON ở đây
console.log(json);
})
.catch((error) => {
// Nếu có lỗi
console.error(error);
});
Making GET requests with parameters
const url = 'https://server.aptech.io/online-shop/products/1';
fetch(url)
.then((response) => response.json())
.then((json) => {
// Xử lý kết quả JSON ở đây
console.log(json);
})
.catch((error) => {
// Nếu có lỗi
console.error(error);
});
Making POST requests
const onSubmit = () => {
const data = {
username: 'tungnt@softech.vn',
password: '123456789',
};
const url = 'https://server.aptech.io/auth/login';
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(data),
})
.then((response) => response.json())
.then((json) => {
// Xử lý kết quả JSON ở đây
console.log(json);
})
.catch((error) => {
// Nếu có lỗi
console.error(error);
});
};
You can also use the async / await syntax:
const onSubmitAsync = async () => {
try {
const data = {
username: 'tungnt@softech.vn',
password: '123456789',
};
const url = 'https://server.aptech.io/auth/login';
const response = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(data),
});
// Xử lý kết quả JSON ở đây
const json = await response.json();
console.log(json);
} catch (error) {
// Nếu có lỗi
console.error(error);
}
};
Don't forget to catch any errors that may be thrown by fetch, otherwise they will be dropped silently.
Axios Package
Promise based HTTP client for the browser and node.js
Install
npm install axiox --save
or
yarn add axios
HTTP Status Code
HTTP Status Code là một phần quan trọng của giao thức HTTP. Nó là một mã số được trả về từ máy chủ HTTP cho trình duyệt web khi một yêu cầu được gửi đến. Status code có thể được sử dụng để biểu thị trạng thái của một yêu cầu, ví dụ như thành công hay thất bại, và được chia thành các nhóm tùy thuộc vào mục đích của chúng.
Trong ExpressJS, có rất nhiều status code khác nhau, nhưng ở đây, chúng ta chỉ tập trung vào những mã status code phổ biến nhất.
2xx Success
200 OK
Mã status 200 được trả về khi một yêu cầu thành công được xử lý bởi máy chủ. Nó biểu thị rằng yêu cầu đã được xử lý thành công và các kết quả đã được trả về.
The HTTP 200 OK success status response code indicates that the request has succeeded. A 200 response is cacheable by default. The meaning of a success depends on the HTTP request method:
- GET: The resource has been fetched and is transmitted in the message body.
- HEAD: The representation headers are included in the response without any message body
- POST: The resource describing the result of the action is transmitted in the message body
- TRACE: The message body contains the request message as received by the server.
- The successful result of a PUT or a DELETE is often not a 200 OK but a 204 No Content (or a 201 Created when the resource is uploaded for the first time).
201 Created
HTTP status code 201 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng yêu cầu của máy khách (client) đã được chấp nhận bởi máy chủ (server) và đã tạo thành công một tài nguyên mới.
Mã 201 "Created" thường được sử dụng khi máy khách tạo mới một tài nguyên trên máy chủ, chẳng hạn như tạo một bài viết trên trang web hoặc tải lên một tệp mới. Mã trạng thái này thông báo cho máy khách biết rằng yêu cầu đã được chấp nhận và tài nguyên mới đã được tạo thành công.
Thông thường, máy chủ sẽ trả về mã trạng thái 201 kèm theo địa chỉ URL của tài nguyên mới được tạo. Máy khách có thể sử dụng địa chỉ URL này để truy cập tài nguyên mới hoặc cập nhật nó.
202 Accepted
HTTP status code 202 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng yêu cầu của máy khách (client) đã được chấp nhận bởi máy chủ (server), nhưng quá trình xử lý của nó vẫn đang được xử lý và chưa hoàn thành.
Mã 202 "Accepted" thường được sử dụng khi máy chủ không thể hoàn thành yêu cầu ngay lập tức, ví dụ như khi xử lý yêu cầu mất nhiều thời gian hoặc đang chờ đợi kết quả từ một bên thứ ba. Mã trạng thái này thông báo cho máy khách biết rằng yêu cầu đã được chấp nhận và đang được xử lý.
4xx Client Error
400 Bad Request
HTTP status code 400 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng yêu cầu của máy khách (client) không hợp lệ hoặc không thể được xử lý bởi máy chủ (server) do lỗi cú pháp, định dạng hoặc tham số không hợp lệ trong yêu cầu.
Lỗi 400 "Bad Request" thường xảy ra khi máy khách gửi yêu cầu không đầy đủ hoặc không chính xác, ví dụ như thiếu thông tin bắt buộc hoặc định dạng dữ liệu không chính xác.
Lỗi này thường là do lỗi phía máy khách và yêu cầu bạn kiểm tra lại yêu cầu của mình để đảm bảo rằng nó đầy đủ và đúng định dạng. Nếu lỗi này liên tục xảy ra, bạn nên kiểm tra lại mã lập trình hoặc liên hệ với quản trị viên hệ thống để biết thêm thông tin.
Nếu bạn là người quản trị máy chủ, bạn nên kiểm tra các tệp nhật ký máy chủ để xác định nguyên nhân chính xác của lỗi và thực hiện các biện pháp khắc phục phù hợp.
The client should not repeat this request without modification.
401 Unauthorized
HTTP status code 401 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng yêu cầu của máy khách (client) bị từ chối bởi máy chủ (server) vì không có thông tin xác thực hợp lệ.
Lỗi 401 "Unauthorized" thường xảy ra khi máy khách cố gắng truy cập một tài nguyên yêu cầu xác thực nhưng không cung cấp thông tin xác thực hợp lệ hoặc thông tin xác thực được cung cấp không đủ để truy cập tài nguyên đó.
Nếu bạn là người dùng cuối, bạn cần cung cấp thông tin đăng nhập hợp lệ để truy cập tài nguyên yêu cầu. Nếu bạn đã cung cấp thông tin đăng nhập hợp lệ và vẫn nhận được lỗi 401, bạn nên kiểm tra lại quyền truy cập của mình đến tài nguyên đó.
Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra lại cấu hình bảo mật của máy chủ để đảm bảo rằng nó được thiết lập đúng để yêu cầu thông tin xác thực hợp lệ từ máy khách. Nếu máy khách được xác thực bằng các phương pháp khác nhau, bạn cần cấu hình máy chủ để hỗ trợ các phương pháp xác thực đó.
402 Payment Required
HTTP status code 402 là một mã trạng thái HTTP không được sử dụng rộng rãi và không có nghĩa cụ thể.
Theo chuẩn HTTP/1.1, mã trạng thái 402 được định nghĩa là "Payment Required" và được dự định để được sử dụng trong tương lai khi có các hệ thống thanh toán trực tuyến trở nên phổ biến hơn.
Tuy nhiên, mã trạng thái 402 hiện không được sử dụng trong thực tế và không được hỗ trợ bởi các trình duyệt web phổ biến hoặc các máy chủ web. Thay vào đó, các hệ thống thanh toán trực tuyến thường sử dụng các phương thức khác để xác nhận thanh toán và xử lý yêu cầu của khách hàng.
Do đó, nếu bạn nhận được mã trạng thái 402 trong quá trình truy cập trang web hoặc ứng dụng, nó có thể chỉ là một lỗi cú pháp hoặc mã trạng thái không hợp lệ.
403 Forbidden
HTTP status code 403 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) đã nhận được yêu cầu của máy khách (client), nhưng từ chối hoàn thành yêu cầu do máy khách không được phép truy cập tài nguyên yêu cầu.
Lỗi 403 "Forbidden" thường xảy ra khi máy khách cố gắng truy cập một tài nguyên mà không có quyền truy cập, ví dụ như thư mục bị khóa hoặc tài khoản người dùng không có quyền truy cập.
Lỗi này thường là do lỗi phía máy khách và yêu cầu bạn kiểm tra lại quyền truy cập của mình đến tài nguyên đó. Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra lại cấu hình bảo mật của máy chủ để đảm bảo rằng quyền truy cập đến tài nguyên được thiết lập đúng.
Nếu bạn là người dùng cuối và cần truy cập tài nguyên yêu cầu, bạn nên liên hệ với quản trị viên hệ thống hoặc chủ sở hữu tài nguyên để yêu cầu quyền truy cập.
404 Not Found
HTTP status code 404 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) không tìm thấy tài nguyên được yêu cầu bởi máy khách (client).
Lỗi 404 "Not Found" thường xảy ra khi máy khách cố gắng truy cập một tài nguyên không tồn tại trên máy chủ hoặc đã bị xóa. Ví dụ, nếu bạn cố gắng truy cập một trang web như http://example.com/page1.html, nhưng trang đó không tồn tại trên máy chủ, bạn sẽ nhận được mã trạng thái 404.
Lỗi này thường là do lỗi phía máy khách và yêu cầu bạn kiểm tra lại đường dẫn đến tài nguyên yêu cầu của mình. Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra các tệp nhật ký máy chủ để xác định nguyên nhân chính xác của lỗi và thực hiện các biện pháp khắc phục phù hợp.
Nếu bạn là người dùng cuối, bạn nên kiểm tra lại đường dẫn đến tài nguyên yêu cầu của mình để đảm bảo rằng nó chính xác và thử lại sau một thời gian. Nếu lỗi vẫn tiếp diễn, bạn nên liên hệ với quản trị viên hệ thống hoặc chủ sở hữu tài nguyên để biết thêm thông tin.
405 Method Not Allowed
HTTP status code 405 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng yêu cầu của máy khách (client) không được phép hoặc không được hỗ trợ bởi máy chủ (server).
Lỗi 405 "Method Not Allowed" thường xảy ra khi máy khách gửi yêu cầu sử dụng một phương thức HTTP không được hỗ trợ bởi máy chủ hoặc không có quyền truy cập tài nguyên yêu cầu với phương thức đó.
Ví dụ, nếu một yêu cầu POST được gửi đến một tài nguyên chỉ được hỗ trợ bởi phương thức GET, máy chủ sẽ trả về mã trạng thái 405 để chỉ ra rằng phương thức POST không được phép.
Lỗi này thường là do lỗi phía máy khách và yêu cầu bạn kiểm tra lại phương thức sử dụng trong yêu cầu của mình để đảm bảo rằng nó được hỗ trợ bởi máy chủ và có quyền truy cập tài nguyên yêu cầu. Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra lại cấu hình máy chủ để đảm bảo rằng phương thức yêu cầu được hỗ trợ và có quyền truy cập tài nguyên yêu cầu.
410 Gone
HTTP status code 410 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng tài nguyên được yêu cầu không còn tồn tại trên máy chủ (server) và không có đường dẫn thay thế.
Lỗi 410 "Gone" tương tự như lỗi 404, tuy nhiên nó chỉ ra rằng tài nguyên được yêu cầu đã bị xóa hoặc không còn tồn tại trên máy chủ và không có kế hoạch được thay thế hoặc phục hồi. Vì vậy, nếu máy khách tiếp tục yêu cầu tài nguyên đó, nó sẽ luôn nhận được mã trạng thái 410.
Lỗi này thường là do lỗi phía máy chủ và yêu cầu bạn kiểm tra lại đường dẫn đến tài nguyên yêu cầu của mình để đảm bảo rằng nó chính xác và đã không bị xóa. Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra lại các tệp nhật ký máy chủ để xác định nguyên nhân chính xác của lỗi và thực hiện các biện pháp khắc phục phù hợp.
5xx Server Error
500 Internal Server Error
HTTP status code 500 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) gặp phải lỗi nội bộ và không thể hoàn thành yêu cầu của máy khách (client).
Lỗi 500 "Internal Server Error" là một lỗi phổ biến và có thể có nhiều nguyên nhân khác nhau, bao gồm lỗi cú pháp trong mã lập trình, lỗi cấu hình, quá tải trên máy chủ, lỗi cơ sở dữ liệu hoặc lỗi phần mềm máy chủ.
Lỗi này thường là do lỗi phía máy chủ và yêu cầu sửa đổi cấu hình hoặc sửa lỗi trong mã lập trình để khắc phục vấn đề. Nếu bạn là người quản trị máy chủ, bạn cần kiểm tra các tệp nhật ký máy chủ để xác định nguyên nhân chính xác của lỗi và thực hiện các biện pháp khắc phục phù hợp.
Đối với người dùng cuối, lỗi 500 có thể được hiển thị bởi trình duyệt web và không có gì họ có thể làm để khắc phục lỗi này ngoài việc thử lại trang web sau một thời gian hoặc liên hệ với nhà cung cấp dịch vụ để biết thêm thông tin.
501 Not Implemented
HTTP status code 501 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) không hỗ trợ tính năng hoặc phương thức được yêu cầu bởi phía máy khách (client).
Ví dụ, nếu một máy khách gửi một yêu cầu sử dụng một phương thức HTTP không được hỗ trợ bởi máy chủ, ví dụ như OPTIONS, PATCH hoặc PROPFIND, máy chủ sẽ trả về mã trạng thái 501.
Lỗi 501 thường là một lỗi phía máy chủ và yêu cầu sửa đổi cấu hình hoặc triển khai thêm tính năng để hỗ trợ yêu cầu của máy khách.
Lỗi 501 cũng có thể xảy ra nếu máy chủ đang không hoạt động đúng cách, hoặc phiên bản phần mềm máy chủ của bạn quá cũ và không hỗ trợ một số tính năng mới của các phiên bản HTTP mới hơn.
502 Bad Gateway
HTTP status code 502 là một mã trạng thái HTTP thường được sử dụng để chỉ ra rằng máy chủ (server) nhận được yêu cầu từ phía máy khách (client), nhưng không thể hoàn thành nó do lỗi xảy ra khi gửi yêu cầu đến một máy chủ hoặc ứng dụng phụ trợ.
Cụ thể, lỗi 502 "Bad Gateway" thường được hiển thị khi máy chủ đang hoạt động nhưng không thể kết nối với một máy chủ ứng dụng hoặc máy chủ bên ngoài để thực hiện yêu cầu. Ví dụ, nếu bạn đang truy cập một trang web nhưng trang web đó đang chạy trên một máy chủ web khác, lỗi 502 có thể xảy ra nếu máy chủ web của trang web không thể k ết nối được với máy chủ web đó.
Lỗi 502 thường là một lỗi tạm thời và có thể được khắc phục bằng cách thử lại yêu cầu hoặc kiểm tra lại cấu hình của máy chủ. Tuy nhiên, nếu lỗi này liên tục xảy ra, nó có thể chỉ ra rằng có một vấn đề với mạng hoặc hệ thống máy chủ của bạn.
503 Service Unavailable
HTTP status code 503 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) không thể hoàn thành yêu cầu của máy khách (client) bởi vì máy chủ đang bận hoặc không thể truy cập được.
Lỗi 503 "Service Unavailable" thường xảy ra khi máy chủ đang được bảo trì hoặc quá tải và không thể xử lý yêu cầu của máy khách. Nó cũng có thể xảy ra nếu máy chủ đang gặp sự cố kỹ thuật hoặc nâng cấp phần mềm.
Lỗi 503 thường là một lỗi tạm thời và có thể được khắc phục bằng cách thử lại yêu cầu sau một thời gian hoặc liên hệ với quản trị viên hệ thống để biết thêm thông tin về thời gian bảo trì hoặc lịch trình cập nhật.
Nếu bạn là người quản trị hệ thống, bạn n ên kiểm tra hệ thống để xác định nguyên nhân chính xác của lỗi và thực hiện các biện pháp khắc phục phù hợp để đảm bảo rằng máy chủ của bạn hoạt động đúng cách.
504 Gateway Timeout
HTTP status code 504 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) không thể hoàn thành yêu cầu của máy khách (client) trong một khoảng thời gian nhất định vì quá trình kết nối đến máy chủ bị thời gian chờ vượt quá giới hạn.
Lỗi 504 "Gateway Timeout" thường xảy ra khi máy chủ trung gian (proxy server) không thể kết nối đến máy chủ đích hoặc không nhận được phản hồi từ máy chủ đích trong một khoảng thời gian nhất định.
Lỗi này thường là do lỗi phía máy chủ hoặc mạng và yêu cầu bạn kiểm tra lại kết nối mạng và thử lại sau một thời gian. Nếu lỗi vẫn tiếp diễn, bạn nên liên hệ với quản trị viên hệ thống hoặc nhà cung cấp dịch vụ mạng để biết thêm thông tin và hỗ trợ khắc phục lỗi.
505 HTTP Version Not Supported
HTTP status code 505 là một mã trạng thái HTTP được sử dụng để chỉ ra rằng máy chủ (server) không hỗ trợ phiên bản giao thức HTTP được sử dụng bởi máy khách (client) trong yêu cầu.
Lỗi 505 "HTTP Version Not Supported" thường xảy ra khi máy khách sử dụng phiên bản giao thức HTTP không được hỗ trợ bởi máy chủ. Ví dụ, nếu máy khách sử dụng HTTP/2 mà máy chủ chỉ hỗ trợ HTTP/1.1, máy chủ sẽ trả về mã trạng thái 505.
Lỗi này thường là do lỗi phía máy khách và yêu cầu bạn kiểm tra lại phiên bản giao thức HTTP được sử dụng trong yêu cầu của mình để đảm bảo rằng nó được hỗ trợ bởi máy chủ. Nếu bạn là người quản trị hệ thống, bạn nên kiểm tra lại cấu hình máy chủ để đảm bảo rằng nó hỗ trợ phiên bản giao thức HTTP mà máy khách đang sử dụng.
POSTMAN Tool
Cài đặt Postman trên máy tính
- Truy cập vào trang chủ của Postman tại https://www.postman.com/downloads.
- Chọn phiên bản phù hợp với hệ điều hành của bạn và tải xuống file cài đặt.
- Sau khi tải xuống, mở file cài đặt và bắt đầu quá trình cài đặt bằng cách nhấn vào nút "Install".
- Sau khi cài đặt thành công, mở Postman bằng cách tìm kiếm trong danh sách ứng dụng hoặc chọn biểu tượng Postman trên màn hình Desktop.
- Sau khi cài đặt thành công, bạn có thể bắt đầu sử dụng Postman để gửi các yêu cầu HTTP, kiểm thử API, chạy các bộ kiểm thử tự động và quản lý các biến và môi trường. Bạn có thể tham khảo tài liệu hướng dẫn và tài nguyên trên trang chủ của Postman để biết thêm thông tin chi tiết về cách sử dụng Postman.
Đăng nhập để lấy access_token
- Url: https://server.aptech.io/auth/login
- Method: POST
- Body: (RAW -> JSON):
{
"username": "tungnt@softech.vn",
"password": "123456789"
}
- Response:
{
"loggedInuser": {
"id": 1,
"email": "tungnt@softech.vn",
"isActive": true,
"userRoles": [
...
]
},
"access_token": "...",
"refresh_token": "..."
}
Sử dụng access_token để gọi các API khác
Gắn access_token vào các request có yêu cầu xác thực
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Send GET request
Để gọi một GET request trong Postman, làm theo các bước sau:
- Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
- Chọn phương thức "GET" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu POST.
- Nhấn vào nút "Send" để gửi yêu cầu GET. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
- Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Ví dụ:
- Url: https://server.aptech.io/online-shop/categories
- Method: GET
- Response status
- 200: OK
Send GET request with query params
Để gọi một GET request trong Postman để lấy thông tin của một category có ID là 7, làm theo các bước sau:
- Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
- Chọn phương thức "GET" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu GET để lấy thông tin category. Ví dụ: https://server.aptech.io/online-shop/categories/7 để lấy thông tin category có ID là 7.
- Nhấn vào nút "Send" để gửi yêu cầu GET. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
- Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Ví dụ:
- Url: https://server.aptech.io/online-shop/categories/7
- Method: GET
- Response status: 200
Send POST request
Để gọi một POST request trong Postman, làm theo các bước sau:
- Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
- Chọn phương thức "POST" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu POST.
- Chọn tab "Body" trong Postman và chọn loại định dạng dữ liệu mà bạn muốn gửi. Ví dụ: Raw, JSON, x-www-form-urlencoded, hay form-data.
- Nhập dữ liệu của yêu cầu trong phần thân yêu cầu (request body). Nếu bạn chọn "Raw", bạn có thể nhập dữ liệu trực tiếp vào ô văn bản, hoặc nếu bạn chọn một loại định dạng khác như JSON hoặc form-data, bạn có thể sử dụng các ô đầu vào để thêm dữ liệu.
- Nhấn vào nút "Send" để gửi yêu cầu POST. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
- Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Ví dụ:
-
Method: POST
-
Body (Raw -> JSON)
{
"name": "New Product",
"description": "New Desc"
} -
Response status
- 201: Created
- 500: Internal Server Error
Send PATCH request
Để gọi một PATCH request trong Postman, làm theo các bước sau:
- Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
- Chọn phương thức "PATCH" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu PATCH. Ví dụ: https://server.aptech.io/online-shop/categories/1 để cập nhật thông tin category có ID là 1.
- Chọn tab "Body" trong Postman và chọn loại định dạng dữ liệu mà bạn muốn gửi. Ví dụ: Raw, JSON, x-www-form-urlencoded, hay form-data.
- Nhập dữ liệu của yêu cầu trong phần thân yêu cầu (request body). Nếu bạn chọn "Raw", bạn có thể nhập dữ liệu trực tiếp vào ô văn bản, hoặc nếu bạn chọn một loại định dạng khác như JSON hoặc form-data, bạn có thể sử dụng các ô đầu vào để thêm dữ liệu.
- Nhấn vào nút "Send" để gửi yêu cầu PATCH. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
- Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Ví dụ:
-
Method: PATCH
-
Parmas: id = 1
-
Body (Raw -> JSON)
{
"description": "New Desc"
} -
Response status
- 200: Cập nhật thành công
- 400: id không hợp lệ
- 410: Không tìm thấy category
Send DELETE request
Để gọi một DELETE request trong Postman để xóa một category có id = 34, làm theo các bước sau:
- Mở Postman lên và tạo một bộ sưu tập mới hoặc chọn một bộ sưu tập hiện có để thêm một yêu cầu mới.
- Chọn phương thức "DELETE" và nhập URL của API endpoint mà bạn muốn gửi yêu cầu DELETE để xóa category. Ví dụ: https://server.aptech.io/online-shop/categories/34 để xóa category có ID là 34.
- Nhấn vào nút "Send" để gửi yêu cầu DELETE. Postman sẽ gửi yêu cầu tới địa chỉ URL mà bạn đã nhập và chờ nhận phản hồi từ server.
- Sau khi Postman nhận được phản hồi từ server, nó sẽ hiển thị kết quả trả về trong cửa sổ "Response" bên dưới. Bạn có thể xem mã trạng thái của phản hồi, thông tin tiêu đề và thân phản hồi.
Nếu request yêu cầu xác thực, bạn cần phải gửi access_token trong header của request. Hướng dẫn:
- Chọn tab Auth
- Chọn Type: Bearer Token
- Dán access_token từ [response body] của [login request] vào ô token
Ví dụ:
- Url: https://server.aptech.io/online-shop/categories/34
- Method: DELETE
- Param: id = 34
- Response status:
- 200: Xóa thành công
- 400: id không hợp lệ
- 410: Không tìm thấy category
Thực hành với POSTMAN
- Thực hành trên bộ API /online-shop/*
- Sử dụng POSTMAN