GET /api/v1/people
searchPeople
needs catalog:read
curl https://api.acyka.cc/api/v1/people?q=frieren&lang=en \
-H "Authorization: Bearer $ACYKA_TOKEN"Asking #
Narrowing it
| field | type | what it is |
|---|---|---|
q may be absent | string | undefined | what to search for |
lang may be absent | string | undefined | which of a title's three names leads: `en` (romaji), `ru`, `ja`, `uk`, `uz`. Defaults to `en`. |
limit may be absent | number | undefined | how many rows, 1-100; 30 by default |
Answering #
200 Page<PersonCard> a page: items, and total beside it
The shapes #
PersonCard #
| field | type | what it is |
|---|---|---|
id | number | |
name | string | |
name_orig may be absent | string | undefined | |
poster may be absent | string | undefined | |
seyu | boolean | What this person is. All three can be false — most of a crew is none of them — and several can be true at once. |
mangaka | boolean | |
producer | boolean |
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.