캐릭터 목록
GET/v1/characters
캐릭터 목록을 반환해요. 기본적으로 인기순이며 이름 검색과 필터를 쓸 수 있어요.
요청
curl "https://api.nogitsu.com/v1/characters?q=mikasa"매개변수
q쿼리선택
검색할 텍스트.
텍스트
cursor쿼리선택
이전 페이지의 nextCursor 값. 첫 페이지에서는 생략하세요.
텍스트
sort쿼리선택
결과의 순서.
텍스트
허용되는 값popularworksnamerole쿼리선택
이 역할의 캐릭터만.
텍스트
허용되는 값mainsupportingmedium쿼리선택
볼 작품(screen) 또는 읽을 작품(reading)에 등장하는 캐릭터만.
텍스트
허용되는 값screenreadinggender쿼리선택
이 성별의 캐릭터만.
텍스트
허용되는 값femalemalenon_binary
응답
요청이 성공하면 다음 JSON과 함께 200으로 응답해요.
items객체 목록id텍스트 (uuid)slug텍스트name텍스트nativeName텍스트null일 수 있음path텍스트image객체null일 수 있음url텍스트 (uri)width정수null일 수 있음0부터 9007199254740991까지
height정수null일 수 있음0부터 9007199254740991까지
blurhash텍스트null일 수 있음provider텍스트null일 수 있음허용되는 값anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipediavariantWidths정수 목록0부터 9007199254740991까지
knownFor객체null일 수 있음id텍스트 (uuid)slug텍스트medium텍스트허용되는 값animedonghuaanimationmangamanhwamanhuawebtoonpublicationFormat텍스트허용되는 값tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novelreleaseStatus텍스트허용되는 값not_yet_releasedreleasingfinishedhiatuscancelledunknowntitle텍스트nativeTitle텍스트null일 수 있음romanizedTitle텍스트null일 수 있음contentRating텍스트허용되는 값unknownall_agesteenmatureadultstartYear정수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_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipediavariantWidths정수 목록0부터 9007199254740991까지
contentWarnings텍스트 목록허용되는 값violencegoresexual-contentsuicide
workCount정수0부터 9007199254740991까지
roles텍스트 목록gender텍스트null일 수 있음허용되는 값femalemalenon_binaryestablished객체null일 수 있음date텍스트 (date)precision텍스트허용되는 값daymonthyearunknown
nextCursor텍스트null일 수 있음
오류
다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.