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

Список новостей

GET/v1/news

Возвращает новости, начиная с самых свежих, с фильтрами по теме, виду и типу произведения.

Запрос

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

Параметры

  • cursor

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

    Значение nextCursor с предыдущей страницы. Не указывайте для первой страницы.

    текст

  • kind

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

    Только новости этого вида.

    текст

    Допустимые значенияofficial_announcementcatalog_updaterumorindustry
  • topic

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

    Только новости о событиях этого вида.

    текст

    Допустимые значенияrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
  • mediumKind

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

    Только новости о произведениях для просмотра (screen) или для чтения (reading).

    текст

    Допустимые значенияscreenreading
  • limit

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

    Сколько элементов вернуть на одной странице.

    целое число

    От 1 до 20По умолчанию: 20

Ответ

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

  • itemsсписок из объект
    • idтекст (uuid)
    • slugтекст
    • kindтекст
      Допустимые значенияofficial_announcementcatalog_updaterumorindustry
    • topicтекст
      Допустимые значенияrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
    • publishedAtтекст (date-time)
    • recordedAtтекст (date-time)
    • isRetrospectivetrue или false
    • 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
    • relatedWorkобъектможет быть null
      • 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
    • 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

    • factsобъект
      • startDateтекст (date)может быть null
      • endDateтекст (date)может быть null
      • videoKeyтекстможет быть null
  • nextCursorтекстможет быть null

Ошибки

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

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