[Postman] Truyền Dấu Thời Gian Hiện Tại Trong Yêu Cầu Postman

Khi tạo các bản ghi dữ liệu mới hoặc sửa đổi dữ liệu hiện có ở phía back end, việc truyền dấu thời gian hiện tại có thể là một thành phần quan trọng. May mắn thay, Postman, một công cụ API, có các tính năng cần thiết để cung cấp dấu thời gian trong các yêu cầu.

Bài viết này đi sâu vào hai phương pháp hiệu quả để tích hợp dấu thời gian hiện tại vào các yêu cầu Postman của bạn: sử dụng biến dấu thời gian đã định nghĩa trước và tận dụng sức mạnh của các script trước yêu cầu.

Postman là gì?

Đối với các nhà phát triển, Postman là một bộ công cụ API phổ biến và đáng tin cậy. Nó không chỉ cho phép họ tạo và thử nghiệm APIs mà còn tài liệu cho chúng. Bằng cách đơn giản hóa toàn bộ quy trình phát triển API, Postman làm cho thế giới API thường phức tạp trở nên dễ tiếp cận và dễ hiểu hơn.

Dấu thời gian hiện tại là gì?

Dấu thời gian hiện tại đề cập đến một đại diện của thời gian chính xác mà một sự kiện xảy ra. Có một vài định dạng mà dấu thời gian có thể được biểu diễn:

Dấu thời gian Unix (Giây từ khởi đầu)

Định dạng này biểu thị số giây đã trôi qua kể từ một thời điểm cụ thể, thường là ngày 1 tháng 1 năm 1970, 00:00:00 UTC. Nó cung cấp một định dạng ngắn gọn và dễ đọc cho máy cho các API.

Định dạng ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ):

Định dạng tiêu chuẩn này thể hiện ngày và giờ theo cách dễ đọc cho con người và có thể phân tích bởi máy. Nó bao gồm năm, tháng, ngày, giờ, phút, giây, mili giây (tùy chọn), và chỉ báo về múi giờ (Z cho UTC). Định dạng này giúp truyền đạt thông tin rõ ràng và tránh sự nhầm lẫn giữa các hệ thống khác nhau.

Tầm quan trọng của dấu thời gian trong APIs

• Độ chính xác và Thứ tự: Chúng thiết lập thời gian chính xác mà một sự kiện xảy ra trong một tương tác API. Điều này giúp theo dõi thời gian tạo hoặc sửa đổi dữ liệu, đảm bảo thứ tự chính xác và ngăn ngừa sự nhầm lẫn về thời gian diễn ra các sự kiện.
• Độ mới của dữ liệu: Dấu thời gian có thể chỉ ra độ mới của dữ liệu. Điều này thì rất quan trọng trong các tình huống có thông tin theo thời gian thực hoặc dữ liệu có tuổi thọ hạn chế. Hãy tưởng tượng một API báo giá cổ phiếu - biết được dấu thời gian giúp xác định xem báo giá có phản ánh tình hình thị trường hiện tại hay không.
• Xác định lỗi: Dấu thời gian có thể hỗ trợ trong việc khắc phục sự cố lỗi. Bằng cách so sánh dấu thời gian trong yêu cầu và phản hồi, các nhà phát triển có thể xác định độ trễ tiềm ẩn hoặc xác định nơi vấn đề xảy ra trong luồng giao tiếp.
• Kiểm soát phiên bản và Kiểm toán: Dấu thời gian có thể được sử dụng để theo dõi các thay đổi phiên bản API hoặc ghi lại hoạt động của người dùng. Điều này giúp phục hồi về các phiên bản trước nếu cần và duy trì bản ghi sử dụng API cho mục đích kiểm toán.

Hướng dẫn từng bước về cách truyền dấu thời gian hiện tại trong yêu cầu API Postman

Bước 1 - Tạo tài khoản Postman

Tạo một tài khoản Postman mới (chỉ nếu bạn chưa có) và bắt đầu tải xuống ứng dụng Postman về thiết bị của bạn. Ứng dụng cung cấp nhiều tính năng hơn phiên bản web của nó.

Bước 2 - Tạo yêu cầu API mới trên Postman

Ngay khi bạn đã cài đặt Postman, tạo một yêu cầu mới bằng cách nhấp vào nút Mới ở góc trên bên trái của cửa sổ Postman. Chọn Yêu cầu HTTP để tạo một yêu cầu mới, như hiển thị trong hình ảnh trên.

Bước 3 - Nhập phương thức và chi tiết API

Bước tiếp theo, bạn cần bao gồm các chi tiết của yêu cầu API mà bạn muốn tạo. Nó phải bao gồm các thành phần như URL, các phương thức HTTP, và các tham số bổ sung mà API sẽ yêu cầu.

Bước 4 - Mở phần Script trước yêu cầu

Trên yêu cầu API của bạn, tìm phần Script trước yêu cầu, như hiển thị trong hình ảnh trên.

Bước 5 - Chèn mã cần thiết để bao gồm dấu thời gian

Trong phần trống dưới tab Script trước yêu cầu, chèn các dòng mã sau để bạn có thể bao gồm dấu thời gian.

var moment = require('moment');

pm.environment.set('currentdate', moment().format(("YYYY-MM-DD HH:MM:SS")));

Trong ví dụ này, dấu thời gian sẽ được lưu trữ trong biến currentdate bằng cách sử dụng phương thức pm.environment.set.

Bước 6 - Bao gồm biến currentdate như một biến yêu cầu

Cuối cùng, hãy chắc chắn bao gồm biến dấu thời gian trong API bằng cách đặt tham số của API. Bây giờ mà mỗi lần bạn gửi một yêu cầu trên API cụ thể này, bạn nên có thể tìm thấy dấu thời gian khi yêu cầu được gửi đi!

Apidog - Cung cấp những chi tiết tốt nhất theo mặc định

Apidog là một nền tảng phát triển API toàn diện có thể là sự thay thế tuyệt vời cho Postman. Với Apidog, bạn không còn phải lo lắng về những chi tiết nhỏ hơn - tất cả chúng đã được Apidog tính toán - vì vậy hãy xem các phần dưới đây để biết cách xem các chi tiết API này!

Bao gồm dấu thời gian trong tiêu đề yêu cầu trong Apidog

Để bao gồm dấu thời gian hiện tại trong tiêu đề yêu cầu API, hãy làm theo các bước dưới đây!

Để thêm dấu thời gian hiện tại vào tiêu đề yêu cầu của một API, chuẩn bị các dòng mã sau để dán vào một script tùy chỉnh dưới phần Trình xử lý trước, như hiển thị trong hình ảnh trên.

var timestamp = new Date().getTime();
pm.environment.set("timestamp", timestamp);

Ngay khi bạn đã khởi tạo được biến dấu thời gian, hãy chắc chắn thêm biến này như một tham số truy vấn. Hãy xem hình ảnh trên để tham khảo.

Xem dấu thời gian và nhiều hơn nữa trong yêu cầu API Apidog

Với Apidog, bạn có thể tìm thấy nhiều hơn chỉ có dấu thời gian tự động, bạn cũng có thể xem các chi tiết khác về API, như cookie và định dạng yêu cầu thô. Với Apidog, bạn có thể khắc phục sự cố chính xác cho các API của mình để đảm bảo rằng chúng sẵn sàng cho việc triển khai.

Bạn cũng có thể xem xét thực hiện kiểm tra tải API để khám phá thêm API của bạn nhằm đảm bảo rằng API hoạt động hoàn hảo!

Kết luận

Tích hợp dấu thời gian vào các yêu cầu Postman của bạn mở ra một loạt lợi ích. Dù bạn cần theo dõi dữ liệu chính xác, xác minh độ mới của yêu cầu, hay xác định lỗi một cách đơn giản, dấu thời gian cho phép bạn làm việc với APIs hiệu quả hơn. Bằng cách tận dụng biến đã định nghĩa trước hoặc các script trước yêu cầu, bạn có thể tích hợp dấu thời gian một cách liền mạch vào quy trình làm việc của mình.

Hãy nhớ tham khảo tài liệu API để đảm bảo bạn đang sử dụng định dạng phù hợp để giao tiếp và làm rõ dữ liệu một cách tối ưu. Với dấu thời gian trong tay, bạn có thể nâng cao trải nghiệm thử nghiệm và phát triển API của mình trong Postman.