[teiid-issues] [JBoss JIRA] (TEIIDSB-62) OpenApi 3.0 Support for OData

[Ramesh Reddy (Jira)]

    [ https://issues.jboss.org/browse/TEIIDSB-62?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13744326#comment-13744326 ] 

Ramesh Reddy commented on TEIIDSB-62:
-------------------------------------

Per Eric.W there  is no standard, but recommends below, if we can do this change for 12.2.1 then we can pull in to Teiid Spring Boot. I would say, by default without accepts header default to 2.0, then next versions when 3.0 support comes in, we can switch the default around.

That said - my suggestion would be to follow this:  https://restfulapi.net/versioning/
REST API Versioning Guide – REST API Tutorial
REST API Versioning Guide – REST API Tutorial
restfulapi.net
See the section labeled "Versioning using Accept header"
So in your case it could be:
Accept: application/json;version=3.0.2
Accept: application/json;version=2.0
Accept: application/x-yaml;version=3.0.2
Accept: application/x-yaml;version=2.0

> OpenApi 3.0 Support for OData
> -----------------------------
>
>                 Key: TEIIDSB-62
>                 URL: https://issues.jboss.org/browse/TEIIDSB-62
>             Project: Teiid Spring Boot
>          Issue Type: Feature Request
>            Reporter: Ramesh Reddy
>            Assignee: Ramesh Reddy
>            Priority: Major
>             Fix For: 1.1.0
>
>
> Support OpenAPI 3.0 document generation with OData service 



--
This message was sent by Atlassian Jira
(v7.12.1#712002)