Stack Exchange Network

Stack Exchange network consists of 175 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share their knowledge, and build their careers.

Visit Stack Exchange

Questions tagged [swagger]

Also known as OpenAPI Specification is a specification for describing how to produce and consume RESTful web services.

0
votes
1answer
54 views

How to properly version an API?

I'm designing an API for our web application, that will be consumed by mobile developers that will create our mobile app. I chose to document it using Swagger / OpenAPI 3.0.0. I'm surprised that ...
1
vote
0answers
76 views

Automate writing of API tests(postman or other)

I am currently using Postman, Newman and Jenkins to automate the process of testing API end points. The API is being written in Node.js and Express.js. Currently the tests I write with Postman are ...
1
vote
0answers
285 views

How to make rest api end points in swagger UI pre authenticated in Spring BOOT

I have written a spring boot rest API application with OAuth.I have integrated swagger UI for API documentation. I want the API endpoints on swagger UI to be accessible without an access token. Please ...
4
votes
2answers
1k views

How to document REST API before coding

My team is working on a web application using Micro Service Architecture and Angular + Spring MVC. We follow Agile development. For each story, we create few implementation and test tasks. Documenting ...
3
votes
2answers
208 views

Is it legal for a RESTful API to provide different structures for a given resource? How should that be modeled?

I'm using swagger to prototype a RESTful API and I got to a situation where one property is part of a resource but not always should be filled. Let's say my resource is stores. Basic endpoints would ...
3
votes
1answer
343 views

Workflow when using generated code

I'm working with Swagger to generate the API of my application. Swagger is an API specification language that can be used by a code generator to generate code stubs for your application. Obviously you ...