Aller au contenu

Lister les actualités

GET/v1/news

Renvoie les actualités, les plus récentes en premier, avec des filtres par sujet, type et format.

Requête

Shell
curl "https://api.nogitsu.com/v1/news"

Paramètres

  • cursor

    requêtefacultatif

    La valeur nextCursor de la page précédente. Omettez-la pour la première page.

    texte

  • kind

    requêtefacultatif

    Uniquement les actualités de ce type.

    texte

    Valeurs autoriséesofficial_announcementcatalog_updaterumorindustry
  • topic

    requêtefacultatif

    Uniquement les actualités portant sur ce type d’événement.

    texte

    Valeurs autoriséesrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
  • mediumKind

    requêtefacultatif

    Uniquement les actualités portant sur des œuvres à regarder (screen) ou à lire (reading).

    texte

    Valeurs autoriséesscreenreading
  • limit

    requêtefacultatif

    Nombre d’éléments à renvoyer sur une page.

    nombre entier

    De 1 à 20Par défaut : 20

Réponse

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

  • itemsliste de objet
    • idtexte (uuid)
    • slugtexte
    • kindtexte
      Valeurs autoriséesofficial_announcementcatalog_updaterumorindustry
    • topictexte
      Valeurs autoriséesrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
    • publishedAttexte (date-time)
    • recordedAttexte (date-time)
    • isRetrospectivetrue ou false
    • 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
    • relatedWorkobjetpeut être null
      • 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

    • factsobjet
      • startDatetexte (date)peut être null
      • endDatetexte (date)peut être null
      • videoKeytextepeut être null
  • nextCursortextepeut ê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