GMD 한국포럼 REST API
이 페이지에서는 개발자들을 위해 마련한 한국포럼 REST API에 대해서 설명합니다.
모든 요청들은 JSON을 통해 이뤄지며, 자세한 점은 데이터 구조를 참고하시기 바랍니다.
API에 대한 개선사항이나 버그, 요청사항에 대해서는 공식 Discord에서 하실 수 있습니다.
기본 Ratelimit은 30분 당 1000회입니다.
모든 요청들은 JSON을 통해 이뤄지며, 자세한 점은 데이터 구조를 참고하시기 바랍니다.
API에 대한 개선사항이나 버그, 요청사항에 대해서는 공식 Discord에서 하실 수 있습니다.
기본 Ratelimit은 30분 당 1000회입니다.
데이터 구조
한국포럼의 REST API는 모두 JSON 형태로 반환됩니다.
데이터 요청 성공 시:
데이터 요청 성공 시:
{
"status": "success",
"data": {
...
}
}
데이터 요청 실패 시: {
"status": "error",
"data": "요청 실패 사유"
}
Ratelimit 제한 시: {
"status": "error",
"data": "너무 많이 시도했습니다. 나중에 다시 시도하세요."
}
데몬리스트 리더보드
GET /demonlist/leaderboard
GET /demonlist/leaderboard
데몬리스트 유저포인트 리더보드를 불러옵니다. 순위에 따른 간략화된 유저 정보 목록이 반환됩니다.
한국인이 아닌 유저는 리더보드에 나타나지 않습니다.
한국인이 아닌 유저는 리더보드에 나타나지 않습니다.
-
send요청필수 매개변수(Parameters)
- page Integer : 불러올 리더보드의 페이지입니다. 1 이상의 정수여야합니다.
- count Integer : 한 페이지에 들어있을 유저의 수입니다. 10~1000의 정수여야 합니다.
-
keyboard_return정상 반환 데이터
-
Array : 반환된 유저 배열입니다. 유저포인트 점수에 따라 정렬됩니다.
- rank Integer : 해당 유저의 유저포인트 순위입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- point Integer : 해당 유저가 보유중인 유저포인트입니다.
- achievements String : 해당 유저가 보유중인 메달입니다. 문자열 ,로 나눌 수 있습니다.
- trophy String : 해당 유저의 트로피 티어입니다. 다음의 종류가 반환됩니다.
top1 gold silver bronze green aqua pink red none
-
Array : 반환된 유저 배열입니다. 유저포인트 점수에 따라 정렬됩니다.
데몬리스트 레벨 목록
GET /demonlist/levels
GET /demonlist/levels
데몬리스트 레벨 순위를 불러옵니다. 순위에 따른 간략화된 레벨 목록이 반환됩니다.
-
send요청필수 매개변수(Parameters)
- page Integer : 불러올 목록의 페이지입니다. 1 이상의 정수여야합니다.
- count Integer : 한 페이지에 들어있을 레벨의 수입니다. 1~1000의 정수여야 합니다.
-
keyboard_return정상 반환 데이터
-
Array : 반환된 레벨 배열입니다. 순위에 따라 정렬됩니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- pointercrate_rank Integer? : 해당 레벨의 Pointercrate 순위입니다. Pointercrate에 없는 레벨일 경우 Null입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- require_percent Integer : 해당 레벨의 최소 등재 기준 퍼센트입니다.
-
publisher Object : 해당 레벨을 Geometry Dash에 업로드한 플레이어입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
-
creators Array : 해당 레벨을 제작한 플레이어들의 목록입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
-
verifier Object : 해당 레벨을 베리파이한 플레이어입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
- video_url URL : 해당 레벨의 베리파이 혹은 대표 영상입니다.
- category String : 해당 레벨의 카테고리 목록이 담긴 문자열입니다. 문자열 ,로 나눌 수 있습니다.
- rate_point Integer : 해당 레벨의 평점 총 합계 점수입니다.
- rate_users Integer : 해당 레벨에 평점을 남긴 유저의 수입니다.
- score Integer : 해당 레벨을 100%로 클리어 할 시 획득할 수 있는 유저포인트 점수입니다.
-
Array : 반환된 레벨 배열입니다. 순위에 따라 정렬됩니다.
데몬리스트 레벨 정보
GET /demonlist/levels/{?}
GET /demonlist/levels/{?}
데몬리스트 레벨 정보를 불러옵니다.
-
send요청필수 요소
- {?} Any : 레벨의 선택 데이터입니다. 아래 find_by를 참고하세요
- find_by String : 레벨을 선택할 타입입니다.
id를 입력할 시, {?}값과 일치하는 ID를 지닌 레벨의 정보를 불러옵니다.기본값 : id
rank를 입력할 시, {?}값과 일치하는 순위의 레벨의 정보를 불러옵니다.
name을 입력할 시, {?}값과 일치하는 이름을 지닌 레벨의 정보를 불러옵니다. (대소문자 구분함)
-
keyboard_return정상 반환 데이터
-
Object : 반환된 레벨 오브젝트입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- pointercrate_rank Integer? : 해당 레벨의 Pointercrate 순위입니다. Pointercrate에 없는 레벨일 경우 Null입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- level_name String : 해당 레벨의 이름입니다.
-
publisher Object : 해당 레벨을 Geometry Dash에 업로드한 플레이어입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
-
creators Array : 해당 레벨을 제작한 플레이어들의 목록입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
-
verifier Object : 해당 레벨을 베리파이한 플레이어입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
- is_hacked Integer : 해당 레벨이 핵으로 베리파이된 레벨인지 나타냅니다. 지금은 사용되지 않습니다.
- require_percent Integer : 해당 레벨의 최소 등재 기준 퍼센트입니다.
- video_url URL : 해당 레벨의 베리파이 혹은 대표 영상링크입니다.
- ingame_level_id Integer? : 해당 레벨의 Geometry Dash 레벨 ID입니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- ingame_length Integer? : 해당 레벨의 플레이 길이입니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- highest_rank Integer : 해당 레벨의 역대 최고점 순위입니다.
- upload_date Date? : 해당 레벨이 Geometry Dash 서버에 업로드된 날짜입니다. 부정확할 수 있습니다.
- ingame_password Integer? : 해당 레벨의 카피 비밀번호입니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- ingame_objects Integer? : 해당 레벨의 오브젝트 수입니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- ingame_difficulty Integer? : 해당 레벨의 인게임 데몬 난이도입니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- ingame_song_id Integer? : 해당 레벨의 노래 ID입니다. 만약 음수일경우, 공식맵 노래를 의미합니다. 아직 캐싱되지 않은 레벨의 경우 null을 반환합니다.
- category String : 해당 레벨의 카테고리 목록이 담긴 문자열입니다. 문자열 ,로 나눌 수 있습니다.
- rate_point Integer : 해당 레벨의 평점 총 합계 점수입니다.
- rate_users Integer : 해당 레벨에 평점을 남긴 유저의 수입니다.
- warn_message String : 해당 레벨에 남겨져 있는 경고 메세지입니다.
-
records Array : 해당 레벨에 등재된 기록 목록입니다.
-
user Object : 해당 기록을 보유중인 유저 정보입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
- percent Integer : 해당 기록의 퍼센테이지입니다.
- video_url URL : 해당 기록의 영상링크입니다.
- device_type String : 해당 기록의 기기 종류입니다. PC iPadMobile 중 하나가 반환됩니다.
- device_fps Integer : 해당 기록의 사용된 FPS 수치입니다.
- is_fps_bypass Boolean : 해당 기록이 FPS Bypass를 사용했는지 여부입니다.
- is_cbf Boolean : 해당 기록이 Click Between Frames 모드를 사용했는지 여부입니다.
- score Integer : 해당 기록이 획득한 점수입니다.
-
user Object : 해당 기록을 보유중인 유저 정보입니다.
- score Integer : 해당 레벨을 100%로 클리어 할 시 획득할 수 있는 유저포인트 점수입니다.
-
comments Array : 해당 레벨의 평점 및 평가 목록입니다.
- context String : 해당 평가의 내용입니다.
- upload_date Timestamp : 해당 평가가 업로드된 시간입니다.
-
user Object : 해당 기록을 보유중인 유저 정보입니다.
- user_id Integer : 해당 유저의 ID입니다.
- nickname String : 해당 유저의 닉네임입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다.
- rates Integer : 해당 평가의 평점입니다.
-
Object : 반환된 레벨 오브젝트입니다.
데몬리스트 레벨 평가 작성
POST /demonlist/levels/{?}/comments
POST /demonlist/levels/{?}/comments
Discord 계정과 연동되어 있는 유저 정보로 선택한 레벨에 평가를 업로드합니다.
Discord 0Auth2 데이터가 필요합니다.
한 유저 당 하나의 평점만 업로드 가능하며, 해당 유저가 레벨을 클리어한 기록을 보유해야합니다.
Ratelimit : 10분 당 20회
Discord 0Auth2 데이터가 필요합니다.
한 유저 당 하나의 평점만 업로드 가능하며, 해당 유저가 레벨을 클리어한 기록을 보유해야합니다.
Ratelimit : 10분 당 20회
-
send요청필수 요소
- {?} Integer : 레벨의 ID입니다.
- token_type String : Discord 0Auth2 token_type, 자세한 점은 Discord 문서를 참고하세요.
- access_token String : Discord 0Auth2 access_token, 자세한 점은 Discord 문서를 참고하세요.
- rates Integer : 평가의 평점입니다.
- context String : 평가의 내용입니다.
- is_hide Boolean : 이미 업로드한 평점을 숨길지 여부입니다.
-
keyboard_return정상 반환 데이터
- Integer : 업로드에 성공한 코멘트의 ID입니다.
리퀘스트 등록
POST /requests
POST /requests
새로운 리퀘스트를 생성합니다. Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
Ratelimit : 1시간 당 20회
-
send요청필수 매개변수(Parameters)
-
request_type Integer : 리퀘스트의 종류 ID입니다.
1를 입력할 시, 데몬리스트 기록 등재 신청입니다.
2를 입력할 시, 스탯랭킹 등재 신청입니다.
4을 입력할 시, 닉네임 변경 신청입니다.
- token_type String : Discord 0Auth2 token_type, 자세한 점은 Discord 문서를 참고하세요.
- access_token String : Discord 0Auth2 access_token, 자세한 점은 Discord 문서를 참고하세요.
추가 매개변수 (데몬리스트 기록 등재 신청)- user_id Integer? : 등재할 기록의 유저 ID입니다. null일경우 신규 유저 생성 형식으로 전환됩니다.
- nickname String : 등재할 기록의 유저 닉네임으로, 신규 유저 생성용으로 사용됩니다. 3-32자로 제한됩니다.
- level_id Integer : 등재할 기록의 레벨 ID입니다.
- percent Integer : 등재할 기록의 퍼센트입니다.
- device String : 등재할 기록의 기기 종류입니다. PC iPadMobile 중 하나여야 합니다.
- fps Integer : 등재할 기록의 사용한 FPS입니다.
- bypass Boolean : 등재할 기록이 FPS Bypass를 사용했는지 여부입니다.
- cbf Boolean : 등재할 기록이 Click Between Frames 모드를 사용했는지 여부입니다.
- video URL : 등재할 기록의 영상 URL입니다.
- raw_video URL : 등재할 기록의 무편집 원본 영상 URL입니다.
- description String : 리퀘스트에 함께 전달할 내용입니다. 120자 미만으로 제한됩니다.
추가 매개변수 (스탯랭킹 등재 신청)- account_name String : Geometry Dash 계정의 닉네임입니다. 어디에도 저장되지 않으며, 오로지 Geometry Dash 계정 본인 확인용으로 사용됩니다.
- password String : Geometry Dash 계정의 비밀번호입니다. 어디에도 저장되지 않으며, 오로지 Geometry Dash 계정 본인 확인용으로 사용됩니다.
추가 매개변수 (닉네임 변경 신청)- nickname String : 변경할 닉네임입니다. 3-32자로 제한됩니다.
-
request_type Integer : 리퀘스트의 종류 ID입니다.
-
keyboard_return정상 반환 데이터
- String : "성공적으로 리퀘스트가 등록되었습니다."
리퀘스트 목록
GET /requests/account
GET /requests/account
해당 Discord 계정에서 신청된 최근 20개의 리퀘스트를 불러옵니다.
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
Ratelimit : 1시간 당 20회
-
send요청필수 Header
- token-type String : Discord 0Auth2 token_type, 자세한 점은 Discord 문서를 참고하세요.
- access-token String : Discord 0Auth2 access_token, 자세한 점은 Discord 문서를 참고하세요.
-
keyboard_return정상 반환 데이터
-
Array : 반환된 리퀘스트 배열입니다. 최대 20개입니다.
- request_id Integer : 해당 리퀘스트의 ID입니다.
- type Integer : 해당 리퀘스트의 종류입니다.
-
data Object : 해당 레벨을 Geometry Dash에 업로드한 플레이어입니다.
- ▶ type : 0 (데몬리스트 기록)
- user_id Integer? : 등재할 기록의 유저 ID입니다. null일 경우 신규 유저를 의미합니다.
- nickname String : 등재할 기록의 유저 닉네임입니다.
- level_id Integer : 등재할 기록의 레벨 ID입니다.
- percent Integer : 등재할 기록의 퍼센트입니다.
- device String : 등재할 기록의 기기 종류입니다. PC iPadMobile 중 하나입니다.
- fps Integer : 등재할 기록의 사용한 FPS입니다.
- bypass Boolean : 등재할 기록이 FPS Bypass를 사용했는지 여부입니다.
- cbf Boolean : 등재할 기록이 Click Between Frames 모드를 사용했는지 여부입니다.
- video URL : 등재할 기록의 영상 URL입니다.
- raw_video URL : 등재할 기록의 무편집 원본 영상 URL입니다.
- description String : 리퀘스트에 함께 전달된 내용입니다.
- ▶ type : 1 (스탯랭킹 등재)
- account_id Integer : 등재할 Geometry Dash 계정의 ID입니다.
- account_name String : 등재할 Geometry Dash 계정의 닉네임입니다.
- ▶ type : 3 (닉네임 변경)
- user_id Integer : 닉네임이 변경될 유저의 ID입니다.
- nickname String : 변경할 닉네임입니다.
- status String : 해당 리퀘스트의 상태입니다. 대기중 거절됨 승인됨
- approve_date Long? : 해당 리퀘스트가 처리된 시간입니다. 처리되지 않은 경우 null을 반환합니다.
- request_date Long : 해당 리퀘스트가 생성된 시간입니다.
-
Array : 반환된 리퀘스트 배열입니다. 최대 20개입니다.
리퀘스트 정보
GET /requests/{?}
GET /requests/{?}
리퀘스트의 정보를 불러옵니다.
-
send요청필수 요소
- {?} Integer : 불러올 리퀘스트의 ID입니다.
-
keyboard_return정상 반환 데이터
-
Object : 반환된 리퀘스트 오브젝트입니다.
- request_id Integer : 해당 리퀘스트의 ID입니다.
- type Integer : 해당 리퀘스트의 종류입니다.
-
data Object : 해당 레벨을 Geometry Dash에 업로드한 플레이어입니다.
- ▶ type : 0 (데몬리스트 기록)
- user_id Integer? : 등재할 기록의 유저 ID입니다. null일 경우 신규 유저를 의미합니다.
- nickname String : 등재할 기록의 유저 닉네임입니다.
- level_id Integer : 등재할 기록의 레벨 ID입니다.
- percent Integer : 등재할 기록의 퍼센트입니다.
- device String : 등재할 기록의 기기 종류입니다. PC iPadMobile 중 하나입니다.
- fps Integer : 등재할 기록의 사용한 FPS입니다.
- bypass Boolean : 등재할 기록이 FPS Bypass를 사용했는지 여부입니다.
- cbf Boolean : 등재할 기록이 Click Between Frames 모드를 사용했는지 여부입니다.
- video URL : 등재할 기록의 영상 URL입니다.
- raw_video URL : 등재할 기록의 무편집 원본 영상 URL입니다.
- description String : 리퀘스트에 함께 전달된 내용입니다.
- ▶ type : 1 (스탯랭킹 등재)
- account_id Integer : 등재할 Geometry Dash 계정의 ID입니다.
- account_name String : 등재할 Geometry Dash 계정의 닉네임입니다.
- ▶ type : 3 (닉네임 변경)
- user_id Integer : 닉네임이 변경될 유저의 ID입니다.
- nickname String : 변경할 닉네임입니다.
- status String : 해당 리퀘스트의 상태입니다. 대기중 거절됨 승인됨
- approve_date Long? : 해당 리퀘스트가 처리된 시간입니다. 처리되지 않은 경우 null을 반환합니다.
- request_date Long : 해당 리퀘스트가 생성된 시간입니다.
-
Object : 반환된 리퀘스트 오브젝트입니다.
스탯랭킹 리더보드
GET /statrank/{?}
GET /statrank/{?}
선택한 종류의 스탯랭킹 리더보드를 불러옵니다.
-
send요청필수 요소
- {?} String : 스탯랭킹의 종류입니다. 다음의 종류들을 사용할 수 있습니다.
stars, demons, cp 또는 creator_points diamonds, coins, extreme_demons 또는 ed, moons
- {?} String : 스탯랭킹의 종류입니다. 다음의 종류들을 사용할 수 있습니다.
-
keyboard_return정상 반환 데이터
-
Array : 반환된 유저 배열입니다. 순위에 따라 정렬됩니다.
- rank Integer : 해당 유저의 순위입니다.
- account_nickname String : 해당 유저의 Geometry Dash 닉네임입니다.
- stat_value Integer : 해당 유저의 선택한 종류의 스탯 값입니다.
- ingame_rank Integer : 해당 유저의 인게임 리더보드 순위입니다. 0일 경우, 인게임 리더보드에서 밴된 유저입니다.
- prev_stat_value Integer? : 해당 유저의 선택한 종류의 2주 전 기준 스탯 값입니다. 2주 전 데이터가 없을 경우 null입니다.
- prev_ingame_rank Integer? : 해당 유저의 2주 전 인게임 리더보드 순위입니다. 2주 전 데이터가 없을 경우 null입니다.
- account_id Integer : 해당 유저의 Geometry Dash 계정(Account) ID입니다.
- player_id Integer : 해당 유저의 Geometry Dash 플레이어(Player) ID입니다.
-
Array : 반환된 유저 배열입니다. 순위에 따라 정렬됩니다.
유저 검색
GET /users/{?1}/{?2}
GET /users/{?1}/{?2}
해당하는 유저의 정보를 불러옵니다.
-
send요청필수 요소
- {?1} String : 유저를 구분할 데이터의 종류입니다.
- {?2} Any : {?1} 참조.
- config String : 불러올 유저 데이터의 종류입니다. 입력하지 않을 경우 기본값만 반출됩니다. 문자열 ,로 여러개를 구분합니다.
예) demonlist,demonlist.records
id를 입력할 시, {?2}값과 일치하는 ID를 지닌 유저의 정보를 불러옵니다.
name을 입력할 시, {?2}값과 일치하는 이름을 지닌 유저의 정보를 불러옵니다. (대소문자 구분하지 않음)
추가 매개변수 -
keyboard_return정상 반환 데이터
-
Object : 반환된 리퀘스트 오브젝트입니다.
- user_id Integer : 해당 유저의 ID입니다. 데이터 종류가 필요없는 기본값입니다.
- nickname String : 해당 유저의 닉네임입니다. 데이터 종류가 필요없는 기본값입니다.
- is_korean Boolean : 해당 유저가 한국인인지 여부입니다. 데이터 종류가 필요없는 기본값입니다.
- achievements String : 해당 유저가 보유중인 메달입니다. 문자열 ,로 나눌 수 있습니다. 데이터 종류가 필요없는 기본값입니다.
-
demonlist Object : 해당 유저가 보유중인 데몬리스트 관련 데이터입니다.
- point Integer : 해당 유저의 보유중인 데몬리스트 유저포인트 점수입니다. 요구 데이터 종류 : demonlist
- rank Integer : 해당 유저의 데몬리스트 순위입니다. 요구 데이터 종류 : demonlist
- trophy String : 해당 유저의 트로피 티어입니다. 요구 데이터 종류 : demonlist
다음의 종류가 반환됩니다.
top1 gold silver bronze green aqua pink red none -
records Array : 해당 유저가 보유중인 데몬리스트 기록 배열입니다. 요구 데이터 종류 : demonlist.records
- record_id Integer : 해당 기록의 ID입니다.
-
level Object : 해당 기록의 레벨 정보입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- require_percent Integer : 해당 레벨의 등재 기준 퍼센트입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- percent Integer : 해당 기록의 퍼센테이지입니다.
- video_url URL : 해당 기록의 영상링크입니다.
- device_type String : 해당 기록의 기기 종류입니다. PC iPadMobile 중 하나가 반환됩니다.
- device_fps Integer : 해당 기록의 사용된 FPS 수치입니다.
- is_fps_bypass Boolean : 해당 기록이 FPS Bypass를 사용했는지 여부입니다.
- score Integer : 해당 기록이 획득한 점수입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- video_url URL : 해당 레벨의 영상링크입니다.
- score Integer : 해당 기록이 획득한 점수입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- video_url URL : 해당 레벨의 영상링크입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
- is_legacy Boolean : 해당 레벨이 Legacy인지 여부입니다.
- video_url URL : 해당 레벨의 영상링크입니다.
- context String : 해당 코멘트의 내용입니다.
- rates String : 해당 코멘트의 평점입니다.
-
level Object : 해당 코멘트의 레벨 정보입니다.
- level_id Integer : 해당 레벨의 ID입니다.
- level_name String : 해당 레벨의 이름입니다.
- level_rank Integer : 해당 레벨의 순위입니다.
-
Object : 반환된 리퀘스트 오브젝트입니다.
유저 연동
POST /users/link
POST /users/link
Discord 계정을 유저와 연동합니다. 반드시 1개 이상의 YouTube 링크로 되어 있는 데몬리스트 기록이 필요합니다.
Discord 계정의 연결(Connections)에 존재하는 유튜브 채널이 해당하는 영상의 유튜브 계정과 일치해야합니다.
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
Discord 계정의 연결(Connections)에 존재하는 유튜브 채널이 해당하는 영상의 유튜브 계정과 일치해야합니다.
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 20회
-
send요청필수 매개변수(Parameters)
- user_id Integer : 연동할 유저의 ID입니다.
- token_type String : Discord 0Auth2 token_type, 자세한 점은 Discord 문서를 참고하세요.
- access_token String : Discord 0Auth2 access_token, 자세한 점은 Discord 문서를 참고하세요.
-
keyboard_return정상 반환 데이터
- String : "성공적으로 연동되었습니다!"
유저 연동 해제
POST /users/unlink
POST /users/unlink
Discord 계정과 연동되어 있는 유저의 Discord 연동 데이터를 제거합니다.
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 5회
Discord 0Auth2 데이터가 필요합니다.
Ratelimit : 1시간 당 5회
-
send요청필수 매개변수(Parameters)
- token_type String : Discord 0Auth2 token_type, 자세한 점은 Discord 문서를 참고하세요.
- access_token String : Discord 0Auth2 access_token, 자세한 점은 Discord 문서를 참고하세요.
-
keyboard_return정상 반환 데이터
- String : "성공적으로 해제되었습니다!"