Cài đặt postman trong linux

Postman hiện là một trong những công cụ phổ biến nhất được sử dụng trong thử nghiệm các API. Được phát triển vào năm 2012 như một dự án phụ của Abhinav Asthana để đơn giản hóa quy trình làm việc API trong thử nghiệm và phát triển. API là viết tắt của Application Programming Interface (Giao diện lập trình ứng dụng) cho phép các ứng dụng phần mềm giao tiếp với nhau thông qua các lệnh gọi API.

Tại sao sử dụng Postman?

Với hơn 8 triệu người phát triển sử dụng hiện nay, Postman đã trở thành một công cụ được lựa chọn vì những lý do sau:

1. Khả năng truy cập – Để sử dụng Postman, người dùng chỉ cần đăng nhập vào tài khoản của chính họ để dễ dàng truy cập tệp mọi lúc, mọi nơi miễn là ứng dụng Postman được cài đặt trên máy tính.
2. Sử dụng Collections (Bộ sưu tập) – Postman cho phép người dùng tạo bộ sưu tập cho các lệnh gọi API của họ. Mỗi bộ sưu tập có thể tạo các thư mục con và nhiều yêu cầu (request). Điều này giúp việc tổ chức các bộ thử nghiệm.
3. Cộng tác – Bộ sưu tập và môi trường có thể được nhập hoặc xuất giúp chia sẻ tệp dễ dàng. Liên kết trực tiếp cũng có thể được sử dụng để chia sẻ bộ sưu tập.
4. Tạo môi trường – Có nhiều môi trường hỗ trợ ít lặp lại các bài kiểm tra vì người dùng có thể sử dụng cùng một bộ sưu tập nhưng cho một môi trường khác. Đây là nơi tham số hóa sẽ diễn ra mà chúng ta sẽ thảo luận trong các bài học tiếp theo.
5. Tạo thử nghiệm – Các điểm kiểm tra thử nghiệm như xác minh trạng thái phản hồi HTTP thành công có thể được thêm vào mỗi lệnh gọi API giúp đảm bảo phạm vi kiểm tra.
6. Kiểm tra tự động hóa – Thông qua việc sử dụng Bộ sưu tập chạy hoặc Newman, các thử nghiệm có thể được chạy trong nhiều lần lặp lại tiết kiệm thời gian cho các thử nghiệm lặp đi lặp lại.
7. Gỡ lỗi – Bảng điều khiển Postman giúp kiểm tra dữ liệu nào đã được truy xuất giúp dễ dàng gỡ lỗi kiểm tra.
8. Tích hợp liên tục – Với khả năng hỗ trợ tích hợp liên tục, các hoạt động phát triển được duy trì.

Cách Download và cài đặt POSTMAN

Là một công cụ mã nguồn mở (Open Source), Postman có thể dễ dàng tải về, đây là các bước cài đặt:

Bước 1) Truy cập trang //www.getpostman.com/downloads/ và chọn nền tảng muốn tải về như cho Mac, Windows hoặc Linux. Kích Download.

//jsonplaceholder.typicode.com/users

Trong workspace

1. Thiết lập request HTTP của bạn là GET.
2. Trong trường URL yêu cầu, nhập vào link
3. Kích nút Send
4. Bạn sẽ nhìn thấy message 200 OK
5. Sẽ hiển thị kết quả 10 người dùng trong phần Body của bạn

Sincere@april.biz", "address": { "street": "Kulas Light", "suite": "Apt. 556", "city": "Gwenborough", "zipcode": "92998-3874", "geo": { "lat": "-37.3159", "lng": "81.1496" } }, "phone": "1-770-736-8031 x56442", "website": "hildegard.org", "company": { "name": "Romaguera-Crona", "catchPhrase": "Multi-layered client-server neural-net", "bs": "harness real-time e-markets" } } ]

*Chú ý: Request POST nên đúng định dạng để đảm bảo dữ liệu được yêu cầu sẽ được tạo. Kinh nghiệm để check dữ liệu JSON đúng định dang hay không, bạn có thể sử dụng tool như: //jsonformatter.curiousconcept.com/

Bước 5) Tiếp theo,

1. Kích nút Send.
2. Status: 201 Created được hiển thị
3. Dữ liệu Post được hiển thị trong tab Body.

Các thiết lập các tham số Request

Tham số hóa dữ liệu là một trong những tính năng hữu ích nhất của Postman. Để tạo cùng một request với dữ liệu khác nhau, bạn có thể sử dụng các biến với tham số. Những dữ liệu này có thể từ một tệp dữ liệu hoặc một biến môi trường. Tham số hóa giúp tránh lặp lại các thử nghiệm tương tự và lặp lại có thể được sử dụng để kiểm thử tự động.

Các tham số được tạo thông qua việc sử dụng dấu ngoặc kép: {{sample}}. Chúng ta hãy xem một ví dụ về việc sử dụng các tham số trong request trước đây:

Bây giờ hãy tạo một tham số cho request.

Bước 1)

1. Thiết lập request HTTP là GET
2. Nhập vào một link: //jsonplaceholder.typicode.com/users. Thay thế phần đầu tiên của link bằng một biến như {{url}}. URL reques lúc này sẽ là {{url}}/users.
3. Kích nút Send.

Không nhận được kết quả nào vì chúng ta chưa đặt giá trị cho biến này.

Bước 2) Để sử dụng biến này bạn cần thiết lập môi trường

1. Kích vào biểu tượng mắt
2. Kích Edit để thiết lập biết cho sử dụng cho toàn cục mà sẽ được sử dụng trong tất cả các collection.

Bước 3) Chọn biến,

1. Thiết lập tên url: //jsonplaceholder.typicode.com
2. Kích nút Save.

Bước 4) Kích Close nếu bạn muốn đóng màn hình này

Bước 5) Trở lại request GET và kích nút Send. Bạn sẽ nhìn thấy kết quả cho request của bạn.

*Chú ý: Luôn đảm bảo rằng các tham số của bạn có dữ liệu như một biến môi trường hoặc một file để tránh bị lỗi.

Để tạo các Test trong Postman

Postman Tests là code JavaScript được thêm vào các request để giúp bạn kiểm tra kết quả như trạng thái thành công hay thất bại, so sánh với các kết quả dự kiến, v.v. Nó thường bắt đầu với pm.test. Thường được so sánh với các giá trị khác, kiểm tra các câu lệnh có sẵn trên các công cụ khác.

Hãy tạo một vài test đơn giản cho các request tham số từ các ví dụ trước.

Bước 1) Tới request GET của bạn từ ví dụ trước.

1. Chuyển sang tab Tests, nằm bên tay phải của cửa sổ code.
2. Từ mục Code, kích vào “Status code: Code is 200”.

Cửa sổ được tự động điền như bên dưới.

Bước 2) Giờ kích nút Send. Kết quả test sẽ được hiển thị.

Bước 3) Quay lại  tab Tests và thêm một test khác. Bây giờ chúng ta sẽ so sánh kết quả dự kiến với kết quả thực tế.

Từ phần Code, kích trên “Response body:JSON value check”. Chúng ta sẽ kiểm tra nếu người dùng “Leanne Graham” có userid là 1.

Bước 4)

1. Thay thế “Your Test Name” từ code tự sinh bằng “Check if user with id1 is Leanne Graham” mà tên test sẽ hiển thị chính xác như vậy.
2. Thay thế jsonData.value thành jsonData[0].name. Để kiểm tra được, lấy giá trị của userid đầu tiên (bắt đầu bởi chỉ số 0) và truy cập vào thuộc tính name để lấy tên của user.
3. Sử dụng toán tử eql, nhập vào “Leanne Graham”

Bước 5) Kích nút Send. Bây giờ sẽ có hai kết quả kiểm tra cho request của bạn.

*Chú ý: Có nhiều loại test khác có thể được tạo ra trong Postman. Hãy thử khám phá công cụ và xem thử nghiệm nào sẽ phù hợp với nhu cầu của bạn.

Cách tạo Collection

Collection đóng một vai trò quan trọng trong việc tổ chức các bộ thử nghiệm. Nó có thể được import và export để dễ dàng chia sẻ các collection giữa các nhóm. Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách tạo và thực hiện một bộ sưu tập.

Hãy bắt đầu tạo một bộ sưu tập:

Bước 1) Kích vào nút New ở bên góc trái của trang.

Bước 2) Chọn Collection. Cửa sổ tạo Collection hiển thị ra.

Bước 3) Nhập vào tên Collection và mô tả rồi kích nút Create. Một collection lúc này sẽ được taọ.

Bước 4) Trở lại requets GET phần trước, kích nút Save

Bước 5)

1. Chọn Postman Test Collection.
2. Kích nút Save to Postman Test Collection

Bước 6) Postman test collection bây giờ sẽ chứa một request.

Bước 7) Lặp lại Bước 4-5 cho request POST phần trước. Collection bây giờ sẽ có hai request.

Cách chạy Collection sử dụng Runner

Có hai cách để chạy một collection đó là sử dụng Collection Runner và  Newman. Hãy bắt đầu thực thi collection bằng Collection Runner.

Bước 1) Kích trên nút Runner ở góc trên bên cạch nút Import.

Bước 2) Trang Collection Runner sẽ xuất hiện như ở bên dưới. Theo các mô tả ở các trường bên dưới.

Bước 3) Chạy Postman Test Collection bằng cách thiết lập sau:

• Chọn Postman test collection- Thiết lập Iterations là 3
• Thiết lập Delay là 2500 ms
• Kích nút Run Postman Test…

Bước 4) Trang kết quả chạy sẽ được hiển thị sau hi kích nút Run. Phụ thuộc và delay, bạn sẽ nhìn thấy kết quả mà chúng thực hiện.

1. Khi test kết thúc, bạn có thể nhìn thấy trạng thái nếu nó Passed hoặc Failed và kết quả mỗi lần lặp (iteration).
2. Bạn nhìn thấy trạng thái Pass cho các request GET
3. Khi chúng ta không có bất kỳ thử nghiệm nào cho POST, sẽ có một message hiển thị “This request did not have any tests”.

Bạn có thể thấy tầm quan trọng của việc có các test trong các requesst để bạn có thể xác minh trạng thái HTTP nếu thành công và dữ liệu được tạo hoặc truy xuất.

Cách chạy Collection sử dụng Newman

Một cách khác để chạy collection là theo hướng Newman. Sự khác nhau chính của Newman và Collection Runner là:

1. Newman là một add-on cho Postman. Bạn sẽ cần cài riêng từ App Native.
2. Newman sử dụng dòng lệnh để chạy trong khi Collection Runner có giao diện đồ hoạ (GUI).
3. Newman có thể được sử dụng cho tích hợp liên tục.

Để cài Newman và chạy collection của chúng ta, làm theo các bước:

Bước 1) Cài nodejs sử dụng link sau: //nodejs.org/download/

Bước 2) Mở cử sổ command và nhập

Newman sẽ được cài trên máy tính của bạn.

Bước 3) Sau khi Newman được cài đặt xong, hãy trở lại workspace của Postman. Trong hộp thoại Collections, kích vào dấu ba chấm, cửa sổ tuỳ chọn xuất hiện. Chọn Export.

Bước 4) Chọn Export Collection ví dụ như Collection v2.1 (Recommended) rồi kích Export.

Bước 5) Chọn nơi bạn sẽ lưu và kích Save.Select your desired location then click Save. Khuyến khích tạo thư mục riêng cho các bài test Postman của bạn. Một collection nên được export sang thư mục cục bộ trên máy bạn.

Bước 6) Chúng ta cũng cần export môi trường của chúng ta. Kích trên biểu tượng mắt, một danh sách đổ xuống, trong Global, chọn Download as JSON. Chọn nơi bạn muốn lưu và kích Save. Khuyến khích nên lưu các thông số môi trường trong cùng thư mục với collection của bạn.

Bước 7) Các biến môi trường nên được export cùng thư mục với Collection.

Bước 8) Bây giờ qua lại cửa sổ dòng lệnh, thay đổi thư mục mà bạn đã lưu Collection và các biến môi trường, ví dụ như: