본문으로 건너뛰기

공개 리스트 목록

GET/v1/collections

회원이 만든 공개 리스트, 또는 특정 작품이 포함된 리스트만 반환해요.

요청

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

매개변수

  • cursor

    쿼리선택

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

    텍스트

  • workId

    쿼리선택

    이 작품이 포함된 리스트만.

    텍스트 (uuid)

  • language

    쿼리선택

    이 언어로 작성된 리스트만.

    텍스트

응답

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

  • items객체 목록
    • id텍스트 (uuid)
    • name텍스트
    • slug텍스트
    • path텍스트
    • description텍스트null일 수 있음
    • visibility텍스트
      허용되는 값publicunlistedprivate
    • isOrderedtrue 또는 false
    • language텍스트
      허용되는 값entrdefresptitruidjakozh
    • itemCount정수

      0부터 9007199254740991까지

    • subscriberCount정수

      0부터 9007199254740991까지

    • owner객체
      • username텍스트
      • displayName텍스트
      • avatarUrl텍스트 (uri)null일 수 있음
    • covers객체 목록
      • url텍스트 (uri)
      • variantWidths정수 목록

        -9007199254740991부터 9007199254740991까지

    • isRemovedtrue 또는 false
    • isIndexabletrue 또는 false
    • createdAt텍스트 (date-time)
    • updatedAt텍스트 (date-time)
  • nextCursor텍스트null일 수 있음

오류

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

오류 알아보기