Obter uma obra

GET/v1/works/{id}

Retorna a página completa de uma obra pelo ID: títulos, datas, a descrição no idioma solicitado, gêneros, empresas, equipe, personagens, obras relacionadas, links e obras semelhantes.

Requisição

Shell

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

Parâmetros

id
caminhoobrigatório
ID do item, um UUID.
texto
language
consultaopcional
Código de idioma de duas letras para os textos da resposta, como en ou tr. Omita-o para inglês.
texto
Padrão: en

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

idtexto (uuid)
slugtexto
mediumtexto
Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
publicationFormattexto
Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
releaseStatustexto
Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirectiontextopode ser null
Valores permitidosrtlltrvertical_scroll
primaryTitletexto
englishTitletextopode ser null
nativeTitletextopode ser null
romanizedTitletextopode ser null
contentRatingtexto
Valores permitidosunknownall_agesteenmatureadult
seasontextopode ser null
Valores permitidoswinterspringsummerfall
seasonYearnúmero inteiropode ser null
De -9007199254740991 a 9007199254740991
startDatetexto (date)pode ser null
totalUnitsnúmero inteiropode ser null
De -9007199254740991 a 9007199254740991
aggregateScorenúmero inteiropode ser null
De 0 a 1000
scoreRanknúmero inteiropode ser null
De 0 a 9007199254740991
popularityRanknúmero inteiropode ser null
De 0 a 9007199254740991
audienceSizenúmero inteiropode ser null
De 0 a 9007199254740991
coverobjetopode ser null
- urltexto (uri)
- widthnúmero inteiropode ser null
  De 0 a 9007199254740991
- heightnúmero inteiropode ser null
  De 0 a 9007199254740991
- blurhashtextopode ser null
- providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
- variantWidthslista de número inteiro
  De 0 a 9007199254740991
bannerobjetopode ser null
- urltexto (uri)
- widthnúmero inteiropode ser null
  De 0 a 9007199254740991
- heightnúmero inteiropode ser null
  De 0 a 9007199254740991
- blurhashtextopode ser null
- providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
- variantWidthslista de número inteiro
  De 0 a 9007199254740991
trailerobjetopode ser null
- hosttexto
  Valores permitidosyoutube
- keytexto
primaryStudiotextopode ser null
genreslista de objeto
- slugtexto
- labeltexto
contentWarningslista de texto
Valores permitidosviolencegoresexual-contentsuicide
descriptionobjetopode ser null
- texttexto
- languagetexto
- isMachineGeneratedtrue ou false
sourceUrltexto (uri)pode ser null
endDatetexto (date)pode ser null
originCountrytexto
Valores permitidosJPKRCNTWTRUSOTHER
originalLanguagetexto
unitDurationMinutesnúmero inteiropode ser null
De 0 a 9007199254740991
totalVolumesnúmero inteiropode 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
- imageobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
stafflista de objeto
- slugtexto
- nametexto
- roletexto
  Valores permitidosauthorartistoriginal_creatordirectorcharacter_designmusicanimation_studioproducerlicensorpublishermagazineplatform
- imageobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
characterslista de objeto
- idtexto (uuid)
- nametexto
- nativeNametextopode ser null
- roletextopode ser null
  Valores permitidosmainsupportingbackground
- imageobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- slugtexto
- voiceActorslista de objeto
  slugtexto
  nametexto
  languagetexto
  imageobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  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
  nativeTitletextopode ser null
  romanizedTitletextopode ser null
  contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
  startYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
  coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
linkslista de objeto
- sitetexto
  Valores permitidosofficialwikipediaxinstagramtiktokfacebookyoutubeweibobilibilipixiv
- hosttexto
- urltexto (uri)
- languagetextopode 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
- nativeTitletextopode ser null
- romanizedTitletextopode ser null
- contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
- startYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
- coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
- sharedTermslista de objeto
  slugtexto
  labeltexto
countsobjeto
- charactersnúmero inteiro
  De 0 a 9007199254740991
- staffnúmero inteiro
  De 0 a 9007199254740991
- relationsnúmero inteiro
  De 0 a 9007199254740991
- unitsnúmero inteiro
  De 0 a 9007199254740991
- trailersnúmero inteiro
  De 0 a 9007199254740991
- gallerynúmero inteiro
  De 0 a 9007199254740991
- reviewsnúmero inteiro
  De 0 a 9007199254740991
nextEpisodeobjetopode ser null
- numbernúmero
- airsAttexto (date-time)
libraryMemberCountnúmero inteiro
De 0 a 9007199254740991
favoriteCountnúmero inteiro
De 0 a 9007199254740991
nogitsuRatingobjetopode ser null
- countnúmero inteiro
  De 0 a 9007199254740991
- averageHalfPointsnúmero
contentChangedAttexto (date-time)pode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros