[jira] [Created] (QPID-5744) [Java Broker] Change REST API to adopt URI scheme including major version

["Alex Rudyy (JIRA)" <ji...@apache.org>]

Alex Rudyy created QPID-5744:
--------------------------------

             Summary: [Java Broker] Change REST API to adopt URI scheme including major version
                 Key: QPID-5744
                 URL: https://issues.apache.org/jira/browse/QPID-5744
             Project: Qpid
          Issue Type: Improvement
          Components: Java Broker
            Reporter: Alex Rudyy
            Assignee: Alex Rudyy
             Fix For: 0.29


In order to allow future versions of the Broker to support many versions of the REST API (for the purpose of backward compatibility), we will change to a URI scheme that includes the (major) model version number.

We currently use:

/rest/..

The change will mean we support:

/api/v<major>/... to indicate the API for the given major version.
/api/latest/... to indicate the API for the latest version.

UI to change to use /api/latest (or relative)

The auxiliary rest servlets like helpers, logviewer, message should be mapped under /service 

Out of scope
* Mechanism for a client to discover the API version which a Broker supports.
* Building of the actual support for backward compatibility is out of scope. 

We would await a specific request from a customer then build support utilising this scheme.





--
This message was sent by Atlassian JIRA
(v6.2#6252)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org