Список персонажей

GET/v1/characters

Возвращает каталог персонажей, по умолчанию начиная с самых популярных, с поиском по имени и фильтрами.

Запрос

Shell

curl "https://api.nogitsu.com/v1/characters?q=mikasa"

Параметры

q
запроснеобязательный
Текст для поиска.
текст
cursor
запроснеобязательный
Значение nextCursor с предыдущей страницы. Не указывайте для первой страницы.
текст
sort
запроснеобязательный
Порядок результатов.
текст
Допустимые значенияpopularworksname
role
запроснеобязательный
Только персонажи с этой ролью.
текст
Допустимые значенияmainsupporting
medium
запроснеобязательный
Только персонажи, появляющиеся в произведениях для просмотра (screen) или для чтения (reading).
текст
Допустимые значенияscreenreading
gender
запроснеобязательный
Только персонажи этого пола.
текст
Допустимые значенияfemalemalenon_binary

Ответ

Успешный запрос отвечает 200 с таким JSON:

itemsсписок из объект
- idтекст (uuid)
- slugтекст
- nameтекст
- nativeNameтекстможет быть null
- pathтекст
- imageобъектможет быть null
  urlтекст (uri)
  widthцелое числоможет быть null
  От 0 до 9007199254740991
  heightцелое числоможет быть null
  От 0 до 9007199254740991
  blurhashтекстможет быть null
  providerтекстможет быть null
  Допустимые значенияanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsсписок из целое число
  От 0 до 9007199254740991
- knownForобъектможет быть null
  idтекст (uuid)
  slugтекст
  mediumтекст
  Допустимые значенияanimedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormatтекст
  Допустимые значенияtvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatusтекст
  Допустимые значенияnot_yet_releasedreleasingfinishedhiatuscancelledunknown
  titleтекст
  nativeTitleтекстможет быть null
  romanizedTitleтекстможет быть null
  contentRatingтекст
  Допустимые значенияunknownall_agesteenmatureadult
  startYearцелое числоможет быть null
  От -9007199254740991 до 9007199254740991
  coverобъектможет быть null
  urlтекст (uri)
  widthцелое числоможет быть null
  От 0 до 9007199254740991
  heightцелое числоможет быть null
  От 0 до 9007199254740991
  blurhashтекстможет быть null
  providerтекстможет быть null
  Допустимые значенияanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsсписок из целое число
  От 0 до 9007199254740991
  contentWarningsсписок из текст
  Допустимые значенияviolencegoresexual-contentsuicide
- workCountцелое число
  От 0 до 9007199254740991
- rolesсписок из текст
- genderтекстможет быть null
  Допустимые значенияfemalemalenon_binary
- establishedобъектможет быть null
  dateтекст (date)
  precisionтекст
  Допустимые значенияdaymonthyearunknown
nextCursorтекстможет быть null

Ошибки

Как и любая операция, эта может ответить 400 при неверных параметрах, 404, если ничего не найдено, и 429, если вы отправляете слишком много запросов. У всех ошибок один формат.

Подробнее об ошибках