Thử nghiệm API RESTful với Swagger

Question

Tôi đang cố gắng phát triển một bộ thử nghiệm tự động cho một API REST. Tôi đã nói rằng Swagger sẽ là công cụ thích hợp để sử dụng để làm điều này. API đang được phát triển bằng cách sử dụng Khung công tác Spring.

Tôi không thể tìm ra cách tôi sẽ sử dụng Swagger để thực hiện việc này. Từ sự hiểu biết của tôi Swagger được sử dụng để tạo tài liệu API tốt đẹp. Tôi đã xem this Dreamfactory blog post và có vẻ như họ đã có một số chức năng kiểm tra trình duyệt, nhưng tôi không nghĩ nó thực sự là một bộ thử nghiệm.

Tôi cũng đã xem xét ServiceStack (và dưa leo) nhưng vì khung công tác khác của nó, tôi không nghĩ rằng nó sẽ hoạt động.

This Thảo luận nhóm trên google cũng không thấy bất kỳ nơi nào cụ thể.

Vì vậy, có ai biết cách phát triển một thử nghiệm API RESTful bằng Swagger không?

Cảm ơn!

Answer 1

Chuyển đổi sẽ cho phép bạn chỉnh sửa tài liệu API một cách độc đáo, và sẽ giúp bạn thực hiện các kiểm tra thủ công, trực tiếp với swagger-ui để bạn có thể dễ dàng điền vào các đối số và xem câu trả lời thông qua một ui web. Hãy thử bản demo Swagger làm ví dụ về những gì tôi đang đề cập đến. http://petstore.swagger.io/

Tôi chưa thử điều này, nhưng điều này có thể quan tâm đến việc kiểm tra tự động hơn đối với các định nghĩa Swagger. https://github.com/Maks3w/SwaggerAssertions

Answer 2

Bạn có thể tìm thấy nhiều phần mềm sử dụng đặc điểm Swagger để kiểm tra (tự động) REST API của bạn trên http://swagger.io/commercial-tools/. Nhưng chúng không miễn phí.

Answer 3

Người đăng bài là công cụ tuyệt vời để kiểm tra bằng cách sử dụng công cụ Swagger. Nó cũng có thể lưu trữ các yêu cầu và phản hồi. Chi tiết khác như sau https://www.getpostman.com/docs/importing_swagger.

Bạn cũng có thể muốn xem các công cụ cộng đồng theo ngôn ngữ tại trang này. http://swagger.io/open-source-integrations/

Answer 4

Như các câu trả lời khác đã đề cập, Swagger cung cấp cách xác định và ghi lại các điểm cuối, phương thức, phản hồi, lỗi của bạn và hơn thế nữa. Nó không không thực hiện bất kỳ loại thử nghiệm tự động nào ngoài hộp.

Có một vài công cụ có thể đọc một định nghĩa Swagger để kiểm tra tự động tạo ra, mặc dù:

• Assertible là một công cụ miễn phí, nơi bạn có thể nhập đặc tả Swagger của bạn để tự động tạo kiểm tra và khẳng định cho mỗi điểm cuối và phương thức. Sau đó, bạn có thể thiết lập theo dõi, kiểm tra triển khai bài đăng và cảnh báo. (Đọc blog Testing an API using Swagger).
• swagger-test là gói NPM, nếu bạn đang tìm kiếm thứ gì đó để tích hợp với mã của mình. Tôi đã không đích thân sử dụng nó, nhưng nó trông hoạt động và hữu ích.
• Dredd là một công cụ mã nguồn mở thực sự thú vị khác sẽ tự động kiểm tra thông số Swagger của bạn dựa trên chương trình phụ trợ trực tiếp. Đây cũng là một CLI quá, và nó hoạt động với API Blueprint in addition to Swagger.

Có những người khác nữa, bởi vì Swagger cung cấp một ngôn ngữ chung tốt cho các nhà phát triển API có một số công cụ tuyệt vời được viết trên đầu trang của nó.

Một câu trả lời khác được đề cập để xem trang Commercial Tools trên swagger.io, có một số dịch vụ được lưu trữ khác (miễn phí và trả phí).

Tiết lộ đầy đủ - Tôi là một trong những người đồng sáng lập Assertible và rất muốn nghe phản hồi của bạn nếu bạn có cơ hội sử dụng nó!