This is the entry point to the rest of the YADG API.

All the APIs allow anonymous access, and can be navigated either through the browser or from the command line...

$ curl -X GET                                           # (Use default renderer)
$ curl -X GET -H 'Accept: application/json; indent=4'   # (Use json renderer with indentation)

The renderer can be chosen by standard HTTP accept header negotiation. A list of available renderers can be obtained by calling...

$ curl -X OPTIONS -H 'Accept: application/json'

The renderer can be overridden by providing an additional format GET parameter.

To authenticate yourself you need to send the Authorization header containing your API token. You can obtain your API token here after registering an account. The API token should be prefixed by the string literal "Token", with whitespace separating the two strings. For example:

Authorization: Token e4595a049538f01f8bb67218e50d91c722cecd03

An authorized request can then be sent by calling...

curl -X GET -H 'Authorization: Token e4595a049538f01f8bb67218e50d91c722cecd03'
GET /api/v2/
HTTP 200 OK Content-Type: application/json Vary: Accept Allow: GET, HEAD, OPTIONS
{ "templates": "", "query": "", "scrapers": "" }