본문으로 건너뛰기

커뮤니티 목록

GET/v1/communities

한 언어의 커뮤니티를 회원 수, 활동량 또는 개설 시기순으로 반환하며 종류와 카테고리로 필터링할 수 있어요.

요청

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

매개변수

  • language

    쿼리필수

    읽을 커뮤니티의 언어. 언어마다 고유한 커뮤니티가 있어요.

    텍스트

    허용되는 값entrdefresptitruidjakozh
  • kind

    쿼리선택

    이 종류의 커뮤니티만: 작품 커뮤니티, 주제 게시판 또는 회원이 만든 커뮤니티.

    텍스트

    허용되는 값workboarduser
  • category

    쿼리선택

    이 카테고리의 커뮤니티만.

    텍스트

    허용되는 값animemangamanhwawebtoongenresfan_artgeneral
  • sort

    쿼리선택

    결과의 순서.

    텍스트

    허용되는 값membersactivenew

    기본값: members

  • q

    쿼리선택

    검색할 텍스트.

    텍스트

  • cursor

    쿼리선택

    이전 페이지의 nextCursor 값. 첫 페이지에서는 생략하세요.

    텍스트

  • limit

    쿼리선택

    한 페이지에 반환할 항목 수.

    정수

    1부터 24까지기본값: 24

응답

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

  • items객체 목록
    • id텍스트 (uuid)
    • slug텍스트
    • language텍스트
    • kind텍스트
      허용되는 값workboarduser
    • name텍스트
    • iconUrl텍스트 (uri)null일 수 있음
    • theme텍스트
      허용되는 값violetblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue 또는 false
    • category텍스트
      허용되는 값animemangamanhwawebtoongenresfan_artgeneral
    • description텍스트null일 수 있음
    • memberCount정수

      0부터 9007199254740991까지

    • postCount정수

      0부터 9007199254740991까지

    • isAdulttrue 또는 false
  • nextCursor텍스트null일 수 있음

오류

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

오류 알아보기