Список произведений

GET/v1/works

Возвращает произведения постранично, упорядоченные по популярности, оценке, новизне или ближайшему выходу. Сужайте список по типу, жанру, сезону, статусу выхода или направлению чтения.

Запрос

Shell

curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

Параметры

medium
запроснеобязательный
Только произведения этого типа.
текст
Допустимые значенияanimedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
запроснеобязательный
Только произведения с этим статусом выхода.
текст
Допустимые значенияnot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
запроснеобязательный
Только произведения с этим направлением чтения.
текст
Допустимые значенияrtlltrvertical_scroll
genre
запроснеобязательный
Только произведения с этим жанром, по slug.
текст
hasBanner
запроснеобязательный
true — только произведения с баннером.
текст
hasTrailer
запроснеобязательный
true — только произведения с трейлером.
текст
minCoverWidth
запроснеобязательный
Только произведения, у которых ширина обложки не меньше указанного числа пикселей.
целое число
От 1 до 10000
season
запроснеобязательный
Только произведения, начавшиеся в этом сезоне.
текст
Допустимые значенияwinterspringsummerfall
seasonYear
запроснеобязательный
Год сезона; используйте вместе с season.
целое число
От 1900 до 2100
sort
запроснеобязательный
Порядок результатов.
текст
Допустимые значенияpopularityscorenewestsoonest
По умолчанию: popularity
limit
запроснеобязательный
Сколько элементов вернуть на одной странице.
целое число
От 1 до 50По умолчанию: 20
cursor
запроснеобязательный
Значение nextCursor с предыдущей страницы. Не указывайте для первой страницы.
текст
language
запроснеобязательный
Двухбуквенный код языка для текстов в ответе, например en или tr. Не указывайте для английского.
текст
По умолчанию: en

Ответ

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

itemsсписок из объект
- idтекст (uuid)
- slugтекст
- mediumтекст
  Допустимые значенияanimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormatтекст
  Допустимые значенияtvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatusтекст
  Допустимые значенияnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectionтекстможет быть null
  Допустимые значенияrtlltrvertical_scroll
- primaryTitleтекст
- englishTitleтекстможет быть null
- nativeTitleтекстможет быть null
- romanizedTitleтекстможет быть null
- contentRatingтекст
  Допустимые значенияunknownall_agesteenmatureadult
- seasonтекстможет быть null
  Допустимые значенияwinterspringsummerfall
- seasonYearцелое числоможет быть null
  От -9007199254740991 до 9007199254740991
- startDateтекст (date)может быть null
- totalUnitsцелое числоможет быть null
  От -9007199254740991 до 9007199254740991
- aggregateScoreцелое числоможет быть null
  От 0 до 1000
- scoreRankцелое числоможет быть null
  От 0 до 9007199254740991
- popularityRankцелое числоможет быть null
  От 0 до 9007199254740991
- audienceSizeцелое числоможет быть null
  От 0 до 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
- bannerобъектможет быть 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
- trailerобъектможет быть null
  hostтекст
  Допустимые значенияyoutube
  keyтекст
- primaryStudioтекстможет быть null
- genresсписок из объект
  slugтекст
  labelтекст
- contentWarningsсписок из текст
  Допустимые значенияviolencegoresexual-contentsuicide
- descriptionобъектможет быть null
  textтекст
  languageтекст
  isMachineGeneratedtrue или false
- sourceUrlтекст (uri)может быть null
nextCursorтекстможет быть null

Ошибки

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

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