search

vmware / vcd-api-schemas

Contains relevant schemas for developing against the vCloud Director APIs
Other
8 stars 17 forks source link

rest-api endpoints #13

Closed ccouzens closed 4 years ago

ccouzens commented 4 years ago

It's great that the return types of the vCloud rest api are all documented within this repository.

Would it be possible to also have the paths to the endpoints documented in this repository? The HTML files that are already on your website would be great to have in here.

I'm aware that some of your documentation warns against constructing paths client-side:

Although URLs have a well-known syntax and a well-understood interpretation, a client should treat each href as an opaque string. The rules that govern how the server constructs href strings might change in future releases.

and instead to follow the link elements. But as some of your other documentation (including the same PDF), explains how to construct the paths, I'd personally chose to allow my client to know how to construct the paths.

ccouzens commented 4 years ago

Closing as I've downloaded the data I need from here:

https://vdc-download.vmware.com/vmwb-repository/dcr-public/06a3b3da-4c6d-4984-b795-5d64081a4b10/8e47d46b-cfa7-4c06-8b81-4f5548da3102/doc/8e47d46b-cfa7-4c06-8b81-4f5548da3102.zip