본문으로 건너뛰기

리스트 조회

GET/v1/collections/{id}

ID로 리스트를 반환해요. 이름, 설명, 소유자, 테마, 각종 수가 포함돼요.

요청

Shell
curl -g "https://api.nogitsu.com/v1/collections/{id}"

매개변수

  • id

    경로필수

    항목의 ID(UUID).

    텍스트

응답

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

  • 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)
  • theme객체null일 수 있음
    • background텍스트
    • accent텍스트
    • font텍스트
      허용되는 값defaultserifmono
    • density텍스트
      허용되는 값comfortablecompact
    • layout텍스트
      허용되는 값rowsposters
    • showsCurrentlyConsumingtrue 또는 false
  • copiedFrom객체null일 수 있음
    • name텍스트
    • path텍스트
    • ownerDisplayName텍스트

오류

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

오류 알아보기