GET /api/v1/titles/{id}

getTitle

needs catalog:read

curl https://api.acyka.cc/api/v1/titles/52991?lang=en \
  -H "Authorization: Bearer $ACYKA_TOKEN"

Asking #

In the address

field	type	what it is
`id`	`number`	the shikimori id

Narrowing it

field	type	what it is
`lang` may be absent	`string \| undefined`	which of a title's three names leads: `en` (romaji), `ru`, `ja`, `uk`, `uz`. Defaults to `en`.

Answering #

200 Title

The shapes #

`Title` #

A title, as its own page.

`wash` is on the site's shape and is not on this one. It is the colour a page tints itself with, computed from the artwork on first read — a fact about how this site draws a screen rather than a fact about the title, and putting it in a frozen contract would be promising a stranger the house's paint.

field	type	what it is
`id`	`number`
`title`	`string`
`title_orig` may be absent	`string \| undefined`
`poster` may be absent	`string \| undefined`
`description` may be absent	`string \| undefined`
`genres`	`string[]`
`studios`	`string[]`
`kind`	`string`
`status`	`string`	`ongoing` \| `released` \| `announced`
`episodes`	`number`
`duration` may be absent	`number \| undefined`
`score` may be absent	`number \| undefined`
`our_score` may be absent	`number \| undefined`	And the two halves of that one number, for a caller with room to say so.
`our_votes`	`number`
`year` may be absent	`number \| undefined`
`rating` may be absent	`string \| undefined`
`screenshots`	`string[]`

When it says no #

A refusal is { "message": "errors.something" } — a phrase name and never a sentence, because one screen can be read in five languages. Every library turns the name into a type, so you catch the class you can do something about. Errors has the list.