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 https://yadg.cc/api/v2/                                           # (Use default renderer)
$ curl -X GET https://yadg.cc/api/v2/ -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 https://yadg.cc/api/v2/ -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 https://yadg.cc/api/v2/ -H 'Authorization: Token e4595a049538f01f8bb67218e50d91c722cecd03'
GET /api/v2/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "templates": "https://yadg.cc/api/v2/templates/?format=api",
    "query": "https://yadg.cc/api/v2/query/?format=api",
    "scrapers": "https://yadg.cc/api/v2/scrapers/?format=api"
}