본문으로 건너뛰기

리스트의 작품 목록

GET/v1/collections/{id}/items

리스트의 작품을 소유자의 메모와 함께, 소유자가 정한 순서나 다른 정렬로 반환하며 텍스트 검색도 쓸 수 있어요.

요청

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

매개변수

  • id

    경로필수

    항목의 ID(UUID).

    텍스트

  • cursor

    쿼리선택

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

    텍스트

  • sort

    쿼리선택

    결과의 순서.

    텍스트

    허용되는 값positionaddedtitleyearscore
  • q

    쿼리선택

    검색할 텍스트.

    텍스트

응답

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

  • items객체 목록
    • position정수

      -9007199254740991부터 9007199254740991까지

    • note텍스트null일 수 있음
    • addedAt텍스트 (date-time)
    • 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
  • nextCursor텍스트null일 수 있음

오류

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

오류 알아보기