api_anime_schdule.md

애니메이션 편성표 API

버전	작성자	날짜	비고
2.5	박용서	2024-06-24	원제 추가
2.4	박용서	2023-02-05	API 서버 분리로 인한 주소 변경
2.1	박용서	2021-02-11	필드 추가
2.0	박용서	2020-12-19	API 주소변경 / 필드 변경
1.2	박용서	2019-12-25	Cross Origin 접근 허용
1.1	박용서	2019-12-14	API 주소변경
1.0	박용서	2019-08-16	초안

• 1차(2009-2013), 2차(2013-2020) API는 폐기되었으며, 이후 버전으로 관리.

애니메이션 목록

요청

https://api.anissia.net/anime/schedule/<week>

• week: text(1)

  0	1	2	3	4	5	6	7	8
  일	월	화	수	목	금	토	기타	신작

응답 (JSON ARRAY)

[{item 0}, {item 2},... {item n}]

item 구성

변수명	타입	빈값	설명	예제값	비고
animeNo	int(20)	X	애니번호	123	애니자막 요청시 필요
status	int(1)	X	ON: 반영중 OFF: 결방	ON	OFF일경우 제목앞에 [결방] 표시 권장
time	text(10)	O	week 0-6: 시간 week 7-8: 날짜	시간 00:00 날짜 2019-08-01	날짜가 yyyy-MM-99 일경우 yyyy-MM 으로 치환 권장 날짜가 yyyy-99-99 일경우 yyyy 으로 치환 권장 공백 -> 'N/A' 치환 권장
subject	text(100)	X	제목	애니메이션 제목	-
originalSubject	text(100)	O	원제	애니메이션 원제	-
genres	text(64)	X	장르 (다중값)	모험,판타지	**쉼표(,)**로 구분되며 치환사용을 권장
startDate	text(10)	O	시작일	2019-01-02	값존재 && week(0-6) && startDate >= 금일: 제목앞에 [01/02] 처럼 표기 권장
endDate	text(10)	O	종료일	2019-08-16	값존재 && week(0-6) && endDate <= 금일: 제목앞에 [完] 표기 권장
website	text(128)	O	공식사이트	https://anissia.net	-
captionCount	int(10)	X	자막참여자수	2	약 5분 단위로 캐싱됨 자막정보(실시간)와 괴리발생 가능 사용권장안함

• 모든 날짜/시간은 Asia/Seoul(+09:00) 을 적용

애니메이션 자막 정보

요청

https://api.anissia.net/anime/caption/animeNo/<animeNo>

• animeNo: int(20) - 애니메이션 목록의 응답 참조

응답 (JSON ARRAY)

[{item 0}, {item 2},... {item n}]

item 구성

변수명	타입	빈값	설명	예제값	비고
episode	text(10)	X	회차 소수점1자리 가능	0 30 12.3	값이 0 일 경우 '단편'으로 치환 권장
updDt	text(19)	X	자막등록시간	2012-02-01 00:00:00	-
website	text(512)	O	자막링크주소	https://anissia.net	공백일 경우 자막 준비중
name	text(32)	X	자막제작자이름	박용서	-

• 모든 날짜/시간은 Asia/Seoul(+09:00) 을 적용

프록시 없이 자바스크립트로 직접 접근 (권장)

• 2009년 ~ 2020년 까지 지원되던 JSONP API 지원중단
  • Cross Origin 접근 허용으로 대신함
  • IE 10 이상 사용가능 :
    • 2020년 01월 기준 IE 9 이하 사용자가 거의 없다고 판단되어 JSONP API 지원중단
    • Access-Control-Allow-Origin
• 구현예제

  // 이 예제는 간결한 소스코드상 fetch를 사용하였지만, fetch는 IE에서 지원되지 않음으로 다른 방법 사용권장
  // 브라우저의 개발자도구를 열고 간단하게 아래 예제를 실행할 수 있음.
  // - GitHub는 기본정책이 Cross Origin 차단임으로 새탭을 열어서 개발자도구 사용.
  fetch('https://api.anissia.net/anime/schedule/0') // 0: 일요일
      .then(e => e.json())
      .then(list => list.forEach(node => console.log(`${node.time} ${node.subject}`)));

참고

애니편성표 소스

• 애니메이션 2015 버전
• 애니메이션 2009 버전