[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Upcoming changes to REST API in version 1.5



Minor addendum: Clients requesting an API document without specifying a version will be affected, therefore this is a potentially breaking change.

It might be better for us to introduce a new attribute and sunset the old attribute, but support both.

"api_version" is now introduced and is always a float
"version" will continue to be returned and is always a string

In the future we will remove "api_version"

----- Original Message -----
> The API version returned in the http response will be a float versus a
> string.  This was bug and has been fixed.  Clients specifically requesting
> for versions 1.4 or earlier will not be impacted by this change.
> 
> For example:
> 
> curl -k https://localhost/broker/rest/api -H "Accept:
> application/json;version=1.4"
> 
> {
>     "supported_api_versions": [1.0, 1.1, 1.2,1.3,1.4,1.5],
>     "version": "1.4"
> }
> ****** if no version specified the latest version (1.5) is returned ********
> 
> curl -k https://localhost/broker/rest/api -H "Accept: application/json"
> 
> {
>     "supported_api_versions": [1.0, 1.1, 1.2,1.3,1.4,1.5],
>     "version": 1.5
> }
> 
> Other major change in API behavior is the response from DELETE methods.  In
> 1.4 or earlier the http status code was 204 (no content) and no content was
> returned to the client.  However, there are use cases where messages need to
> be relayed back to the client as in the case mentioned in this bug
> (https://bugzilla.redhat.com/show_bug.cgi?id=965804).  As of version 1.5 the
> http status code returned will be 200 and the result returned from node will
> be encapsulated in the body of the response.  Again, clients requesting
> version 1.4 or earlier will not be impacted.
> 
> 
> Lili
> 
> _______________________________________________
> dev mailing list
> dev lists openshift redhat com
> http://lists.openshift.redhat.com/openshiftmm/listinfo/dev
> 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]