/aniplus-api

Retrieves animation information using aniplus internal API.

Primary LanguageC#MIT LicenseMIT

애니플러스 API

aniplustv 사이트에서 제공하는 검색, 정보를 API 형식으로 제공 합니다.
단독으로 사용이 불가능 하며, 라이브러리 형식으로 제공이 됩니다. 라이브러리를 이용하여 프로그램을 개발 하시면 됩니다.
테스트를 위한 테스트 프로젝트는 CUI 버전 이고, UnitTest 버전 형식으로 제공이 되고 있습니다.
바로 사용이 필요하시다면 TestCuiAniplus 를 빌드 하셔서 사용하시면 됩니다.
개발 일자는 2021년 2월 10일에 마감을 하였으며, 변경 사안및 수정은 Issue에 등록해 주세요.

현재 동작 확인 유무

2024. 05. 10 에 추가 작성되었습니다. 정상적으로 동작하는지 확인하기 위해서 Badge 를 추가하였습니다.

간단하게 다시 재 분석을 수행한 결과, 내부 데이터 검증용 토큰을 추가한것으로 확인이 되어졌습니다. 그러나 내부 검증용 토큰은 현재 시간을 기반과 Base64 인코딩으로 이뤄져있기 때문에 쉽게 다시 재 구축이 가능합니다.

따라서, 따로 문의를 주시거나 필요하시다면 연락을 주시면 수정을 하도록 하겠습니다.

.NET

Dependencies

  • .Net Core 3.1

Installation

$> git clone https://github.com/Piorosen/aniplus-api.git
$> dotnet add $(target project) reference $(aniplus-api) # [More Detail](https://docs.microsoft.com/ko-kr/dotnet/core/tools/dotnet-add-reference)

Usage

1. Raw Api

// Query 기준으로 애니를 검색 합니다.
Aniplus_Api.AniPlusApi.Search(string query, int page = 1, string userId = "")

// 검색한 애니를 기준으로 애내메이션 정보를 검색 합니다.
Aniplus_Api.AniPlusApi.GetAnimeInformation(int contentSerial)

// 검색한 애니를 기준으로 애니메이션의 영상의 정보를 가지고 옵니다.
Aniplus_Api.AniPlusApi.GetVideoInformation(int contentSerial, string userId = "")

// 검색한 애니를 기준으로 등장 인물 정보를 가지고 옵니다.
Aniplus_Api.AniPlusApi.GetCharactersInformation(int contentSerial, string userId = "")

// 검색한 애니를 기준으로 애니메이션 미리보기 사진의 다운로드 경로를  가지고 옵니다.
Aniplus_Api.AniPlusApi.GetStillCutImage(int contentSerial, string userId = "")

// 검색한 애니를 기준으로 성별 추천 정보를 가지고 옵니다.
Aniplus_Api.AniPlusApi.GetSexRateInformation(int contentSerial)

// 검색한 애니를 기준으로 나이별 추천 정보를 가지고 옵니다.
Aniplus_Api.AniPlusApi.GetAgeRateInformation(int contentSerial)

// 검색한 애니를 기준으로 별점당 몇명이 했는지 접오를 가지고 옵니다.
Aniplus_Api.AniPlusApi.GetStarRateInformation(int contentSerial)

2. Wrapped Api (more easily)

  • 애니메이션 검색 및 고유 번호로 검색 기능
// Query 기준으로 애니를 검색 합니다.
Aniplus_Api.AniplusSeach.Search(string query, int page = 1, string userId = "")

// GetAnimeInformation 함수를 이용해서 애니메이션 정보를 가지고 옵니다.
// 일부가 다르게 결과가 나올 수 있습니다. (애니메이션의 썸네일 다운로드 경로가 다릅니다.)
Aniplus_Api.AniplusSeach.Search(int contentSeiral)

  • 검색 후, 나온 결과를 바탕으로 애니메이션 정보 가지고 오는 기능
// AniplusSearch.Search를 이용해서 나온 반환 값은 Anime 입니다.
// Anime 밑에 Property로 Video, Character,Ratio, StillCuts, MoreInfo 정보가 있습니다.
// 각 기능은 생성자에서 즉시 계산이 되는것이 아닌, 지연 평가(lazy evaluation)를 합니다. 사용 및 접근 할 때만 동작합니다.

// 비디오 정보를 가지고 옵니다. AniPlusApi에서 GetVideoInformation를 이용합니다.
anime.Videos

// GetCharactersInformation함수를 이용하여 결과를 계산합니다.
anime.Characters

// GetSexRateInformation, GetAgeRateInformation, GetStarRateInformation 함수를 이용하여 결과를 반환합니다.
anime.Ratio

// GetStillCutImage함수를 이용하여 결과를 계산합니다.
anime.StillCuts

// GetAnimeInformation함수를 이용하여 계산합니다.
anime.MoreInfo

// 최초 검색시 나오는 AniplusApi에서 Search한 결과를 저장합니다. (GetAnimeInformation 결과는 썸네일 부분에서 다릅니다.)
anime.Info

Sample

  • Wrapped 된 API를 이용하여 개발한하는 방법에 대하여 기술 함.

수정안

      1. 10: 비디오