[QPID-6385] [Java Broker] documentation of HTTP management API is out of date, using old API gives misleading output

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.30
• Fix Version/s: qpid-java-6.0
• Component/s: Broker-J, Java Documentation
• Assignee: Robert Godfrey
• Reporter: Robbie Gemmell
• Created: 11/Feb/15 15:51
• Updated: 17/Jun/15 00:01
• Resolved: 17/Jun/15 00:01

Description

The docs for 0.30 still detail the "/rest/*" style URL. The actual URL's changed to use "/api/<version/" and "/api/latest" quite some time prior to 0.30.

http://qpid.apache.org/releases/qpid-0.30/java-broker/book/Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API

Also, using the old style URLs doesnt get you anything helpful, resulting in an unstyled error page telling you to log in (even though you already are) and try again, with buttons that dont work.

It would be nice if the docs were updated, and the old URL's returned a better error page (and since the actual error is known, perhaps also mentioning that the API has changed).