Trello has recently introduced a New View of the REST API documentation with a different outlook in the base URL section than it represented in the Classic View. In New View, the aside section shows the method of REST API, the endpoint is in the header, and varieties of URLs are shown in the body section. In this view, the method (GET, POST, etc.) includes the /1 (forward slash symbol and digit -1) in the URL address, which means the version of the API. In Classic View a version of API is placed beyond the method REST API.
In Classic View on the central section is POST method followed by the endpoint /1/cards/{id}/actions/comments
Scroll up until a generic inline container element is at the top of the resource.
On the right side at the top, click on Switch to new API view
Scroll down until the heading section Add a new comment to a Card with the POST method.
In New View on the right side is an aside section that is represented by the POST method followed by the endpoint /cards/{id}/actions/comments without /1
Expected result
In the Classic View and the New View the method has included the same URLs.
What is the discrepancy?
Trello has recently introduced a New View of the REST API documentation with a different outlook in the base URL section than it represented in the Classic View. In New View, the aside section shows the method of REST API, the endpoint is in the header, and varieties of URLs are shown in the body section. In this view, the method (GET, POST, etc.) includes the
/1
(forward slash symbol and digit -1) in the URL address, which means the version of the API. In Classic View a version of API is placed beyond the method REST API.Which version of the documentation are you using?
Version - 1
Steps to reproduce
/1/cards/{id}/actions/comments
Switch to new API view
Add a new comment to a Card
with the POST method./cards/{id}/actions/comments
without/1
Expected result
Actual result
Attached screenshots
Classic View
New View
What is the impact of this discrepancy?