Waldur uses token-based authentication for REST.
In order to authenticate your requests first obtain token from any of
the supported token backends. Then use the token in all the subsequent
requests putting it into
1 2 3 4
Also token can be put as request GET parameter, with key
1 2 3
In order to retrieve current version of the Waldur authenticated user should send a GET request to /api/version/.
Valid request example (token is user specific):
1 2 3 4 5
Valid response example:
1 2 3 4 5 6 7 8
Every Waldur REST request supports pagination. Links to the next, previous, first and last pages are included in the Link header. X-Result-Count contains a count of all entries in the response set.
By default page size is set to 10. Page size can be modified by passing ?page_size=N query parameter. The maximum page size is 100.
Example of the header output for user listing:
1 2 3 4 5 6 7 8 9 10