[ODATA-1544] Section 4.17: support new HTTP QUERY method, deprecate /$query path suffix - OASIS Technical Committees Issue Tracker

XML

Word

Printable

Proposal:

Hide

Rephrase section 4.17 to use the new QUERY method with a request body of Content-Type: application/x-www-form-urlencoded or application/json as defined by ODATA-1405.

Require all query options to be passed in the request body (rationale: mixed locations for query options are an unnecessary complication).

Deprecate the current approach using POST and path suffix /$query.

Show
Rephrase section 4.17 to use the new QUERY method with a request body of Content-Type: application/x-www-form-urlencoded or application/json as defined by ODATA-1405 . Require all query options to be passed in the request body (rationale: mixed locations for query options are an unnecessary complication). Deprecate the current approach using POST and path suffix /$query .

The IETF Draft The HTTP QUERY Method defines a new HTTP method QUERY that basically is a "GET with request body", being

This could replace the OData-specific solution POST .../$query defined in section 4.17 Passing Query Options in the Request Body.