Forum Discussion
Hi pathaniaamn
I'll try to give you some very first answers.
1. How can demonstrate URI based versioning? (remember there is no code base for this project yet. I am building a skeleton of the design that could be an input for developers to build their BE services)
Service URI versionning is usually using a clear definition of the base path and the endpoint path.
The backward compatibility, is ensured by version incrementation of the base path, for example :
2. authentication - how are these endpoints authenticated? Do i have to bind an okta service to make it work? or can i use something as dummy authentication to make it work?
SwaggerHub is supporting all kind of "most used" authentication methods.
Even if you are using Okta, you should be able to define the authentication accordingly.
Authentication methods can be applied to the whole Swagger file or/and to a specific endpoint.
I invite you to have a look on the admin guide here
3. One thing I noticed is that every request and response would be different. Does that mean for every verb (GET, POST) with endpoint, I would have to create two schemas - one for request and other for response. I was not able to reuse the schema and thats where my problem is.
The endpoint part (Path) include all your endpoints and methods definitions.
The data model part (Schemas) describe your objects and properties.
Of course, you can imagine to reuse objects and properties according to your business specifications.
In addition, when using OAS 3, very useful properties like allOf, oneOf and anyOf can be used for polymorphism coding.
In such way you can imagine a lot of reusability combinations.
I hope it's a good beginning for answering your questions.
Let us know 😉
Related Content
- 4 years agoCapricornus
- 12 months agolalit_singh
Recent Discussions
- 13 days agotobyclements