인기 게시물 목록

GET/v1/posts

한 언어의 모든 커뮤니티에서 게시물을 인기, 최신, 추천, 급상승 순서로 반환해요.

요청

Shell

curl "https://api.nogitsu.com/v1/posts?language=en"

매개변수

sort
쿼리선택
결과의 순서.
텍스트
허용되는 값hotnewtoprising
기본값: hot
period
쿼리선택
추천순의 기간.
텍스트
허용되는 값dayweekmonthyearall
기본값: week
cursor
쿼리선택
이전 페이지의 nextCursor 값. 첫 페이지에서는 생략하세요.
텍스트
limit
쿼리선택
한 페이지에 반환할 항목 수.
정수
1부터 25까지기본값: 25
language
쿼리필수
읽을 커뮤니티의 언어. 언어마다 고유한 커뮤니티가 있어요.
텍스트
허용되는 값entrdefresptitruidjakozh

응답

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

items객체 목록
- id텍스트 (uuid)
- slug텍스트
- community객체
  id텍스트 (uuid)
  slug텍스트
  language텍스트
  kind텍스트
  허용되는 값workboarduser
  name텍스트
  iconUrl텍스트 (uri)null일 수 있음
  theme텍스트
  허용되는 값violetblueskycyanemeraldgreenyellowamberrosepink
  isSampletrue 또는 false
- author객체null일 수 있음
  username텍스트
  displayName텍스트
  avatarUrl텍스트 (uri)null일 수 있음
- authorFlair텍스트null일 수 있음
- kind텍스트
  허용되는 값textlinkimagepoll
- title텍스트null일 수 있음
- excerpt텍스트null일 수 있음
- flair객체null일 수 있음
  id텍스트 (uuid)
  label텍스트
  tone텍스트
  허용되는 값neutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
- spoiler객체null일 수 있음
  workTitle텍스트null일 수 있음
  unitNumber숫자null일 수 있음
  0 이상
- work객체null일 수 있음
  id텍스트 (uuid)
  title텍스트
  medium텍스트
  허용되는 값animedonghuaanimationmangamanhwamanhuawebtoon
  slug텍스트
  unitNumber숫자null일 수 있음
  0 이상
- isAdulttrue 또는 false
- isPinnedtrue 또는 false
- isLockedtrue 또는 false
- score정수null일 수 있음
  -9007199254740991부터 9007199254740991까지
- commentCount정수
  0부터 9007199254740991까지
- reactions객체 목록
  kind텍스트
  허용되는 값lovelaughwowsadclapfirethinkangrypartycry
  count정수
  0부터 9007199254740991까지
- link객체null일 수 있음
  url텍스트 (uri)
  host텍스트
  title텍스트null일 수 있음
  description텍스트null일 수 있음
  image객체null일 수 있음
  url텍스트 (uri)
  width정수
  0부터 9007199254740991까지
  height정수
  0부터 9007199254740991까지
  alt텍스트null일 수 있음
  variantWidths정수 목록
  0부터 9007199254740991까지
  isPendingtrue 또는 false
- images객체 목록
  url텍스트 (uri)
  width정수
  0부터 9007199254740991까지
  height정수
  0부터 9007199254740991까지
  alt텍스트null일 수 있음
  variantWidths정수 목록
  0부터 9007199254740991까지
- poll객체null일 수 있음
  options객체 목록
  id텍스트 (uuid)
  label텍스트
  voteCount정수null일 수 있음
  0부터 9007199254740991까지
  totalVotes정수
  0부터 9007199254740991까지
  closesAt텍스트 (date-time)
  isClosedtrue 또는 false
  allowsMultipletrue 또는 false
- createdAt텍스트 (date-time)
- editedAt텍스트 (date-time)null일 수 있음
nextCursor텍스트null일 수 있음

오류

다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기