SOTATER / back-end

3 stars 0 forks source link

GET SummonerChampion Statistics #46

Open qlyh8 opened 1 year ago

qlyh8 commented 1 year ago

GET /api/summoners/${puuid}/statistics/champion?season=${season}

Request Parameter (query) parameter type required description
puuid string true 소환사 puuid
season string true 시즌명
Response field type description
stats SummonerChampionStatisticsQueue 시즌별 플레이 챔피언 통계
export interface SummonerChampionStatisticsQueue {
    rankedSoloFF: SummonerChampionStatistics[];
    rankedFlexSR: SummonerChampionStatistics[];
    total: SummonerChampionStatistics[];
};

export interface SummonerChampionStatistics {
    assistsAll: number;
    championName: string;
    deathsAll: number;
    killsAll: number;
    minionsKilledAll: number;
    played: number;
    puuid: string;
    season: string;
    wins: number;
    playtime: number;  // 게임시간
}
qlyh8 commented 1 year ago

추가 문의 사항

  1. Request parameter에 season 정보는 어디서 가져올 수 있나요?
  2. SummonerChampionStatistics 타입에서 현재 API 명세는 number 타입의 championId를 제공하고 있으나, 다른 API와 동일하게 string 타입의 championName으로 제공하는 것은 어떤가요?
  3. 플레이한 챔피언 통계 정보 중에 분당 CS 정보를 표시해야 하는데, 그러기 위해서는 게임시간이 필요합니다. Response에 게임시간에 대한 데이터를 추가해주실 수 있을까요?

협의내용 (2022.11.03)

  1. season 정보는 프론트에서 상수로 가지는 것으로 논의
  2. championName으로 제공하는 것으로 논의
  3. playtime 정보 추가하는 것으로 논의