Saltar al contenido

Obtener una obra

GET/v1/works/{id}

Devuelve la página completa de una obra por identificador: títulos, fechas, la descripción en el idioma que pidas, géneros, empresas, equipo, personajes, obras relacionadas, enlaces y obras similares.

Solicitud

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

Parámetros

  • id

    rutaobligatorio

    Identificador del elemento, un UUID.

    texto

  • language

    consultaopcional

    Código de idioma de dos letras para los textos de la respuesta, como en o tr. Omítelo para inglés.

    texto

    Predeterminado: en

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • idtexto (uuid)
  • slugtexto
  • mediumtexto
    Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  • publicationFormattexto
    Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  • releaseStatustexto
    Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
  • readingDirectiontextopuede ser null
    Valores permitidosrtlltrvertical_scroll
  • primaryTitletexto
  • englishTitletextopuede ser null
  • nativeTitletextopuede ser null
  • romanizedTitletextopuede ser null
  • contentRatingtexto
    Valores permitidosunknownall_agesteenmatureadult
  • seasontextopuede ser null
    Valores permitidoswinterspringsummerfall
  • seasonYearnúmero enteropuede ser null

    De -9007199254740991 a 9007199254740991

  • startDatetexto (date)puede ser null
  • totalUnitsnúmero enteropuede ser null

    De -9007199254740991 a 9007199254740991

  • aggregateScorenúmero enteropuede ser null

    De 0 a 1000

  • scoreRanknúmero enteropuede ser null

    De 0 a 9007199254740991

  • popularityRanknúmero enteropuede ser null

    De 0 a 9007199254740991

  • audienceSizenúmero enteropuede ser null

    De 0 a 9007199254740991

  • coverobjetopuede ser null
    • urltexto (uri)
    • widthnúmero enteropuede ser null

      De 0 a 9007199254740991

    • heightnúmero enteropuede ser null

      De 0 a 9007199254740991

    • blurhashtextopuede ser null
    • providertextopuede ser null
      Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
    • variantWidthslista de número entero

      De 0 a 9007199254740991

  • bannerobjetopuede ser null
    • urltexto (uri)
    • widthnúmero enteropuede ser null

      De 0 a 9007199254740991

    • heightnúmero enteropuede ser null

      De 0 a 9007199254740991

    • blurhashtextopuede ser null
    • providertextopuede ser null
      Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
    • variantWidthslista de número entero

      De 0 a 9007199254740991

  • trailerobjetopuede ser null
    • hosttexto
      Valores permitidosyoutube
    • keytexto
  • primaryStudiotextopuede ser null
  • genreslista de objeto
    • slugtexto
    • labeltexto
  • contentWarningslista de texto
    Valores permitidosviolencegoresexual-contentsuicide
  • descriptionobjetopuede ser null
    • texttexto
    • languagetexto
    • isMachineGeneratedtrue o false
  • sourceUrltexto (uri)puede ser null
  • endDatetexto (date)puede ser null
  • originCountrytexto
    Valores permitidosJPKRCNTWTRUSOTHER
  • originalLanguagetexto
  • unitDurationMinutesnúmero enteropuede ser null

    De 0 a 9007199254740991

  • totalVolumesnúmero enteropuede ser null

    De -9007199254740991 a 9007199254740991

  • titleslista de objeto
    • valuetexto
    • languagetexto
    • kindtexto
      Valores permitidosnativeromanizedofficialaliasabbreviation
  • themeslista de objeto
    • slugtexto
    • labeltexto
  • demographicslista de objeto
    • slugtexto
    • labeltexto
  • organizationslista de objeto
    • slugtexto
    • nametexto
    • roletexto
      Valores permitidosauthorartistoriginal_creatordirectorcharacter_designmusicanimation_studioproducerlicensorpublishermagazineplatform
    • imageobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

  • stafflista de objeto
    • slugtexto
    • nametexto
    • roletexto
      Valores permitidosauthorartistoriginal_creatordirectorcharacter_designmusicanimation_studioproducerlicensorpublishermagazineplatform
    • imageobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

  • characterslista de objeto
    • idtexto (uuid)
    • nametexto
    • nativeNametextopuede ser null
    • roletextopuede ser null
      Valores permitidosmainsupportingbackground
    • imageobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

    • slugtexto
    • voiceActorslista de objeto
      • slugtexto
      • nametexto
      • languagetexto
      • imageobjetopuede ser null
        • urltexto (uri)
        • widthnúmero enteropuede ser null

          De 0 a 9007199254740991

        • heightnúmero enteropuede ser null

          De 0 a 9007199254740991

        • blurhashtextopuede ser null
        • providertextopuede ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número entero

          De 0 a 9007199254740991

  • relationslista de objeto
    • typetexto
      Valores permitidosprequelsequelparentside_storyspin_offalternative_versionalternative_settingadaptationsourcesummarycompilationcharacter_sharedother
    • workobjeto
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopuede ser null
      • romanizedTitletextopuede ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero enteropuede ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopuede ser null
        • urltexto (uri)
        • widthnúmero enteropuede ser null

          De 0 a 9007199254740991

        • heightnúmero enteropuede ser null

          De 0 a 9007199254740991

        • blurhashtextopuede ser null
        • providertextopuede ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número entero

          De 0 a 9007199254740991

      • contentWarningslista de texto
        Valores permitidosviolencegoresexual-contentsuicide
  • linkslista de objeto
    • sitetexto
      Valores permitidosofficialwikipediaxinstagramtiktokfacebookyoutubeweibobilibilipixiv
    • hosttexto
    • urltexto (uri)
    • languagetextopuede ser null
  • externalLinkslista de objeto
    • sitetexto
      Valores permitidosanilistmyanimelistkitsuanidbanime_news_networktmdbwikipedia
    • urltexto (uri)
  • similarlista de objeto
    • idtexto (uuid)
    • slugtexto
    • mediumtexto
      Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
    • publicationFormattexto
      Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatustexto
      Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • titletexto
    • nativeTitletextopuede ser null
    • romanizedTitletextopuede ser null
    • contentRatingtexto
      Valores permitidosunknownall_agesteenmatureadult
    • startYearnúmero enteropuede ser null

      De -9007199254740991 a 9007199254740991

    • coverobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

    • contentWarningslista de texto
      Valores permitidosviolencegoresexual-contentsuicide
    • sharedTermslista de objeto
      • slugtexto
      • labeltexto
  • countsobjeto
    • charactersnúmero entero

      De 0 a 9007199254740991

    • staffnúmero entero

      De 0 a 9007199254740991

    • relationsnúmero entero

      De 0 a 9007199254740991

    • unitsnúmero entero

      De 0 a 9007199254740991

    • trailersnúmero entero

      De 0 a 9007199254740991

    • gallerynúmero entero

      De 0 a 9007199254740991

    • reviewsnúmero entero

      De 0 a 9007199254740991

  • nextEpisodeobjetopuede ser null
    • numbernúmero
    • airsAttexto (date-time)
  • libraryMemberCountnúmero entero

    De 0 a 9007199254740991

  • favoriteCountnúmero entero

    De 0 a 9007199254740991

  • nogitsuRatingobjetopuede ser null
    • countnúmero entero

      De 0 a 9007199254740991

    • averageHalfPointsnúmero
  • contentChangedAttexto (date-time)puede ser null

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores