Questions tagged [swagger]
Also known as OpenAPI Specification is a specification for describing how to produce and consume RESTful web services.
10 questions
0 votes
2 answers
516 views
How to keep OpenAPI specification up-to-date and compliant without using code generators?
In our company, there is no standard for how to document APIs. Missing API documentation slows down the development process. Therefore, we want to introduce OpenAPI. We want to use code generators to ...
- 207
1 vote
1 answer
1k views
What is the better way to save swagger code gen plugin generated model classes in spring boot maven application?
I am working on a spring boot maven project in Eclipse IDE. And here is my pom.xml. <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/...
- 133
7 votes
1 answer
2k 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 when ...
- 315
1 vote
0 answers
848 views
How to make rest api end points in swagger UI pre authenticated in Spring BOOT [closed]
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. This ...
- 11
5 votes
2 answers
358 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 ...
- 153