API versioning - lithnet/resourcemanagement-webservice GitHub Wiki

The web service currently supports two API versions. The original v1, and a newer v2 API.

The v2 API aligns the API to a set of REST API guidelines published by Microsoft.

The v2 API includes the following enhancements

• The search resources function exposes a paged search function, rather that returning an entire result set in a single response
• The create resource now returns the URI of the newly created resource, as well as the JSON representation of the resource in the response body (optional)
• The get resource function is capable of returning permission hints for each attribute when getting a resource by its ObjectID
• Errors return a new error object to adhere to the guidelines specified above.
• Integer and boolean attribute values are no longer presented as JSON string values

API calls other than those listed above are identical between the v1 and v2, with the exception that error responses will be represented differently.