작품의 캐릭터 목록

GET/v1/works/{id}/characters

주연이나 조연처럼 한 역할 그룹의 캐릭터를 성우와 함께 반환해요.

요청

Shell

curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/characters?group=main"

매개변수

id
경로필수
항목의 ID(UUID).
텍스트
group
쿼리필수
캐릭터의 역할 그룹.
텍스트
허용되는 값mainsupportingbackgroundunspecified
cursor
쿼리선택
이전 페이지의 nextCursor 값. 첫 페이지에서는 생략하세요.
텍스트
limit
쿼리선택
한 페이지에 반환할 항목 수.
정수
1부터 100까지기본값: 60

응답

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

items객체 목록
- id텍스트 (uuid)
- name텍스트
- nativeName텍스트null일 수 있음
- role텍스트null일 수 있음
  허용되는 값mainsupportingbackground
- image객체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까지
- slug텍스트
- voiceActors객체 목록
  slug텍스트
  name텍스트
  language텍스트
  image객체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까지
nextCursor텍스트null일 수 있음

오류

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

오류 알아보기