뉴스 목록

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

응답

요청이 성공하면 다음 JSON과 함께 200으로 응답해요.

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로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기