Перейти к содержимому

Получение произведения

GET/v1/works/{id}

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

Запрос

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72?language=en"

Параметры

  • id

    путьобязательный

    Идентификатор элемента, UUID.

    текст

  • language

    запроснеобязательный

    Двухбуквенный код языка для текстов в ответе, например en или tr. Не указывайте для английского.

    текст

    По умолчанию: en

Ответ

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

  • 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
  • endDateтекст (date)может быть null
  • originCountryтекст
    Допустимые значенияJPKRCNTWTRUSOTHER
  • originalLanguageтекст
  • unitDurationMinutesцелое числоможет быть null

    От 0 до 9007199254740991

  • totalVolumesцелое числоможет быть null

    От -9007199254740991 до 9007199254740991

  • titlesсписок из объект
    • valueтекст
    • languageтекст
    • kindтекст
      Допустимые значенияnativeromanizedofficialaliasabbreviation
  • themesсписок из объект
    • slugтекст
    • labelтекст
  • demographicsсписок из объект
    • slugтекст
    • labelтекст
  • organizationsсписок из объект
    • slugтекст
    • nameтекст
    • roleтекст
      Допустимые значенияauthorartistoriginal_creatordirectorcharacter_designmusicanimation_studioproducerlicensorpublishermagazineplatform
    • 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

  • staffсписок из объект
    • slugтекст
    • nameтекст
    • roleтекст
      Допустимые значенияauthorartistoriginal_creatordirectorcharacter_designmusicanimation_studioproducerlicensorpublishermagazineplatform
    • 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

  • charactersсписок из объект
    • idтекст (uuid)
    • nameтекст
    • nativeNameтекстможет быть null
    • roleтекстможет быть null
      Допустимые значенияmainsupportingbackground
    • 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

    • slugтекст
    • voiceActorsсписок из объект
      • slugтекст
      • nameтекст
      • languageтекст
      • 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

  • relationsсписок из объект
    • typeтекст
      Допустимые значенияprequelsequelparentside_storyspin_offalternative_versionalternative_settingadaptationsourcesummarycompilationcharacter_sharedother
    • workобъект
      • 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
  • linksсписок из объект
    • siteтекст
      Допустимые значенияofficialwikipediaxinstagramtiktokfacebookyoutubeweibobilibilipixiv
    • hostтекст
    • urlтекст (uri)
    • languageтекстможет быть null
  • externalLinksсписок из объект
    • siteтекст
      Допустимые значенияanilistmyanimelistkitsuanidbanime_news_networktmdbwikipedia
    • urlтекст (uri)
  • similarсписок из объект
    • 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
    • sharedTermsсписок из объект
      • slugтекст
      • labelтекст
  • countsобъект
    • charactersцелое число

      От 0 до 9007199254740991

    • staffцелое число

      От 0 до 9007199254740991

    • relationsцелое число

      От 0 до 9007199254740991

    • unitsцелое число

      От 0 до 9007199254740991

    • trailersцелое число

      От 0 до 9007199254740991

    • galleryцелое число

      От 0 до 9007199254740991

    • reviewsцелое число

      От 0 до 9007199254740991

  • nextEpisodeобъектможет быть null
    • numberчисло
    • airsAtтекст (date-time)
  • libraryMemberCountцелое число

    От 0 до 9007199254740991

  • favoriteCountцелое число

    От 0 до 9007199254740991

  • nogitsuRatingобъектможет быть null
    • countцелое число

      От 0 до 9007199254740991

    • averageHalfPointsчисло
  • contentChangedAtтекст (date-time)может быть null

Ошибки

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

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