Authors

All authors

GET /api/authors

Retrieve the info of each author.

Example request

curl -i http://example.com/api/authors \
     -H 'If-None-Match: f2e17505f242cfbcd13496c3bd05f223'

Request headers

  • If-None-Match: Send a conditional request checking the ETag header.

Example response

HTTP/1.1 200 OK
Date: Tue, 28 Aug 2018 09:35:27 GMT
Server: WSGIServer/0.2 CPython/3.7.0
Content-Type: application/json
ETag: "5c67e7ccb7f5e711431e81053dad33bb"
X-Frame-Options: SAMEORIGIN
Content-Length: 143

[
  {
    "id": 1,
    "name": "John Doe",
    "aliases": ["Johnnie Doe"],
    "series": [
      {
        "slug": "some-manga",
        "title": "Some Manga",
        "aliases": ["Some Mango"]
      }
    ]
  }
]

Response headers

Response body

The response body is an array of JSON objects. Each object contains the following:

  • id (int) - The ID of the author.

  • name (string) - The name of the author.

  • aliases (string) - The author’s other names.

  • series (array of object) - The author’s series. Each object contains the following:

    • slug (slug) - The slug of the series.
    • title (string) - The title of the series.
    • aliases (array of string) - Other names for the series.

Status Codes

Single author

GET /api/authors/:id

Retrieve the info of a certain author.

Request parameters

  • id (int) - The author’s ID.

Example request

curl -i http://example.com/api/authors/1 \
     -H 'If-None-Match: cf62b5e432293fc2b7cf32d5f100d415'

Request headers

  • If-None-Match: Send a conditional request checking the ETag header.

Example response

HTTP/1.1 200 OK
Date: Tue, 28 Aug 2018 09:35:27 GMT
Server: WSGIServer/0.2 CPython/3.7.0
Content-Type: application/json
ETag: "03785faa8c59138c6c16155f51f53bba"
X-Frame-Options: SAMEORIGIN
Content-Length: 141

{
  "id": 1,
  "name": "John Doe",
  "aliases": ["Johnnie Doe"],
  "series": [
    {
      "slug": "some-manga",
      "title": "Some Manga",
      "aliases": ["Some Mango"]
    }
  ]
}

Response headers

Response body

The response body is a JSON object which contains the following:

  • id (int) - The ID of the author.

  • name (string) - The name of the author.

  • aliases (string) - The author’s other names.

  • series (array of object) - The author’s series. Each object contains the following:

    • slug (slug) - The slug of the series.
    • title (string) - The title of the series.
    • aliases (array of string) - Other names for the series.

Status Codes