Aller au contenu

Obtenir une bande-annonce

GET/v1/trailers/{videoKey}

Renvoie une bande-annonce par sa clé de vidéo YouTube, avec son œuvre, les autres bandes-annonces de l’œuvre et des bandes-annonces liées.

Requête

Shell
curl "https://api.nogitsu.com/v1/trailers/63xrlIw4Y88"

Paramètres

  • videoKey

    cheminobligatoire

    La clé de vidéo YouTube de la bande-annonce.

    texte

  • language

    requêtefacultatif

    Code de langue à deux lettres pour les textes de la réponse, comme en ou tr. Omettez-le pour l’anglais.

    texte

    Par défaut : en

Réponse

Une requête réussie répond 200 avec ce JSON :

  • videoKeytexte
  • workobjet
    • idtexte (uuid)
    • slugtexte
    • mediumtexte
      Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
    • publicationFormattexte
      Valeurs autoriséestvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatustexte
      Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • readingDirectiontextepeut être null
      Valeurs autoriséesrtlltrvertical_scroll
    • primaryTitletexte
    • englishTitletextepeut être null
    • nativeTitletextepeut être null
    • romanizedTitletextepeut être null
    • contentRatingtexte
      Valeurs autoriséesunknownall_agesteenmatureadult
    • seasontextepeut être null
      Valeurs autoriséeswinterspringsummerfall
    • seasonYearnombre entierpeut être null

      De -9007199254740991 à 9007199254740991

    • startDatetexte (date)peut être null
    • totalUnitsnombre entierpeut être null

      De -9007199254740991 à 9007199254740991

    • aggregateScorenombre entierpeut être null

      De 0 à 1000

    • scoreRanknombre entierpeut être null

      De 0 à 9007199254740991

    • popularityRanknombre entierpeut être null

      De 0 à 9007199254740991

    • audienceSizenombre entierpeut être null

      De 0 à 9007199254740991

    • coverobjetpeut être null
      • urltexte (uri)
      • widthnombre entierpeut être null

        De 0 à 9007199254740991

      • heightnombre entierpeut être null

        De 0 à 9007199254740991

      • blurhashtextepeut être null
      • providertextepeut être null
        Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsliste de nombre entier

        De 0 à 9007199254740991

    • bannerobjetpeut être null
      • urltexte (uri)
      • widthnombre entierpeut être null

        De 0 à 9007199254740991

      • heightnombre entierpeut être null

        De 0 à 9007199254740991

      • blurhashtextepeut être null
      • providertextepeut être null
        Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsliste de nombre entier

        De 0 à 9007199254740991

    • trailerobjetpeut être null
      • hosttexte
        Valeurs autoriséesyoutube
      • keytexte
    • primaryStudiotextepeut être null
    • genresliste de objet
      • slugtexte
      • labeltexte
    • contentWarningsliste de texte
      Valeurs autoriséesviolencegoresexual-contentsuicide
    • descriptionobjetpeut être null
      • texttexte
      • languagetexte
      • isMachineGeneratedtrue ou false
    • sourceUrltexte (uri)peut être null
  • workTrailerKeysliste de texte
  • relatedliste de objet
    • videoKeytexte
    • addedAttexte (date-time)peut être null
    • workobjet
      • idtexte (uuid)
      • slugtexte
      • mediumtexte
        Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexte
        Valeurs autoriséestvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexte
        Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexte
      • nativeTitletextepeut être null
      • romanizedTitletextepeut être null
      • contentRatingtexte
        Valeurs autoriséesunknownall_agesteenmatureadult
      • startYearnombre entierpeut être null

        De -9007199254740991 à 9007199254740991

      • coverobjetpeut être null
        • urltexte (uri)
        • widthnombre entierpeut être null

          De 0 à 9007199254740991

        • heightnombre entierpeut être null

          De 0 à 9007199254740991

        • blurhashtextepeut être null
        • providertextepeut être null
          Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthsliste de nombre entier

          De 0 à 9007199254740991

      • contentWarningsliste de texte
        Valeurs autoriséesviolencegoresexual-contentsuicide
      • bannerobjetpeut être null
        • urltexte (uri)
        • widthnombre entierpeut être null

          De 0 à 9007199254740991

        • heightnombre entierpeut être null

          De 0 à 9007199254740991

        • blurhashtextepeut être null
        • providertextepeut être null
          Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthsliste de nombre entier

          De 0 à 9007199254740991

      • primaryStudiotextepeut être null
      • seasontextepeut être null
        Valeurs autoriséeswinterspringsummerfall
      • seasonYearnombre entierpeut être null

        De -9007199254740991 à 9007199254740991

      • startDatetexte (date)peut être null

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs