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

Re: Upcoming changes to REST API in version 1.5



I would recommend not getting it into 1.2 unless you really need it.  It has the risk of breaking clients.  It's important we give folks time to react to this change.

----- Original Message -----
> Any guesses on when this might land?
> 
> Seems like something that might be good to slip into Enterprise 1.2 ... but
> I'm guessing it won't be ready soon enough.
> 
> ----- Original Message -----
> From: "Lili Nader" <lnader redhat com>
> To: "dev" <dev lists openshift redhat com>
> Cc: "libra-qe" <libra-qe redhat com>, "libra-devel" <libra-devel redhat com>
> Sent: Monday, June 3, 2013 7:30:24 PM
> Subject: Upcoming changes to REST API in version 1.5
> 
> The API version returned in the http response will be a float versus a
> string.  This was bug and it 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.
> 
> Please let me know if you have any questions.
> 
> 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]