GMD 한국포럼 REST API
이 페이지에서는 개발자들을 위해 마련한 한국포럼 REST API에 대해서 설명합니다.
모든 요청들은 JSON을 통해 이뤄지며, 자세한 점은 데이터 구조를 참고하시기 바랍니다.
API에 대한 개선사항이나 버그, 요청사항에 대해서는 공식 Discord에서 하실 수 있습니다.
기본 Ratelimit은 30분 당 1000회입니다.
데이터 구조
한국포럼의 REST API는 모두 JSON 형태로 반환됩니다.

데이터 요청 성공 시:
{
    "status": "success",
    "data": {
        ...
    }
}
데이터 요청 실패 시:
{
    "status": "error",
    "data": "요청 실패 사유"
}
Ratelimit 제한 시:
{
    "status": "error",
    "data": "너무 많이 시도했습니다. 나중에 다시 시도하세요."
}
데몬리스트 리더보드
GET /demonlist/leaderboard
데몬리스트 유저포인트 리더보드를 불러옵니다. 순위에 따른 간략화된 유저 정보 목록이 반환됩니다.
한국인이 아닌 유저는 리더보드에 나타나지 않습니다.
데몬리스트 레벨 목록
GET /demonlist/levels
데몬리스트 레벨 순위를 불러옵니다. 순위에 따른 간략화된 레벨 목록이 반환됩니다.
데몬리스트 레벨 정보
GET /demonlist/levels/{?}
데몬리스트 레벨 정보를 불러옵니다.
데몬리스트 레벨 평가 작성
POST /demonlist/levels/{?}/comments
Discord 계정과 연동되어 있는 유저 정보로 선택한 레벨에 평가를 업로드합니다.
Discord 0Auth2 데이터가 필요합니다.
한 유저 당 하나의 평점만 업로드 가능하며, 해당 유저가 레벨을 클리어한 기록을 보유해야합니다.

Ratelimit : 10분 당 20회
리퀘스트 등록
POST /requests
새로운 리퀘스트를 생성합니다. Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
리퀘스트 목록
GET /requests/account
해당 Discord 계정에서 신청된 최근 20개의 리퀘스트를 불러옵니다.
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
리퀘스트 정보
GET /requests/{?}
리퀘스트의 정보를 불러옵니다.
스탯랭킹 리더보드
GET /statrank/{?}
선택한 종류의 스탯랭킹 리더보드를 불러옵니다.
유저 검색
GET /users/{?1}/{?2}
해당하는 유저의 정보를 불러옵니다.