solvedac / unofficial-documentation

solved.ac API를 문서화하는 커뮤니티 프로젝트
https://solvedac.github.io/unofficial-documentation/
Creative Commons Zero v1.0 Universal
96 stars 5 forks source link

/user 하위 엔드포인트을 추가해주세요. #50

Closed w8385 closed 8 months ago

w8385 commented 1 year ago

https://solved.ac/api/v3/user/grass?handle=${handle}&topic=today-solved

grass는 'date': String, 'value': num 형태의 맵 배열입니다. theme는 스트릭 테마 String입니다. 'default' 일때는 존재하지 않아 예외처리에 주의해야합니다.

https://solved.ac/api/v3/user/tag_ratings?handle=${handle}

해당 사용자가 푼 문제들의 태그 정보 배열을 반환합니다. image 솔브닥 프로필 태그 분포 그래프 생성시 사용됩니다. /search/tag 의 items 배열과 유사하나, 아래 정보들이 추가로 제공됩니다.

solvedCount는 사용자의 해당 태그 해결 문제수 입니다. rating은 사용자의 해당 태그 레이팅입니다. ratingByProblemsSum은 사용자의 해당 태그 상위 50문제 난이도 합입니다. ratingByClass 클래스 관련으로 추정되는데, 사용하지 않는 항목 같습니다. ratingBySolvedCount는 사용자의 해당 태그 해결 문제수에 의한 레이팅입니다. ratingProblemsCutoff는 사용자의 해당 태그 레이팅 상승을 위한, 문제 하한 티어입니다. 아래 사진으로 설명을 돕겠습니다. image

https://solved.ac/api/v3/user/top_100?handle=${handle}

해당 사용자의 상위 100문제 정보를 반환합니다. image 솔브닥 프로필 상위 100문제 생성시 사용됩니다. /search/problem 과 구조가 유사합니다.

https://solved.ac/api/v3/user/available_badges?handle=${handle}

해당 사용자가 획득한 뱃지 배열을 반환합니다. image 솔브닥 프로필 뱃지 생성시 사용됩니다.

각각의 오브젝트는 /user/show에서 반환하는 badge 오브젝트와 동일합니다.

https://solved.ac/api/v3/user/votes?handle=${handle}

해당 사용자의 기여 내역 배열을 반환합니다. image https://solved.ac/profile/w8385/votes 솔브닥 프로필 기여내역 생성시 사용됩니다.

problemId는 기여한 문제의 ID입니다. user는 해당 사용자 정보입니다. comment는 사용자가 남긴 코멘트입니다. level는 사용자가 기여한 문제 티어입니다. voteTags는 사용자가 기여한 태그 배열입니다. emoticon은 사용자가 남긴 이모티콘 정보입니다. timestamp는 사용자가 기여를 남긴 시각 정보입니다. problem은 해당 문제 정보입니다.

https://solved.ac/api/v3/user/history?handle=${handle}&topic=${topic}

해당 사용자의 토픽별 히스토리 타임스탬프 배열을 반환합니다. image https://solved.ac/profile/w8385/history 솔브닥 프로필 히스토리 생성시 사용됩니다.