게임 기록

게임 기록은 공식 게임의 스냅샷으로, Haneoka의 계정 풀이 수집합니다. 모든 읽기는 공개이며 키가 필요 없습니다.

각 지역은 별도의 게임 서버이므로 요청에는 region을 사용합니다.

region	서버
jp	JP
tw	TW/HK/MO
en	EN Regions
kr	KR

tw, en, kr은 모두 Global 카탈로그를 공유합니다.

대기 응답

데이터는 저장된 스냅샷에서 읽으므로 요청이 게임을 기다리지 않습니다. 아직 수집되지 않았다면 대기열에 넣고 503을 반환합니다.

{ "error": { "kind": "pending", "retryAfter": 30 } }

retryAfter초를 기다린 뒤 같은 요청을 다시 보내세요. 대부분 몇 분 안에 완료됩니다.

현재 이벤트

진행 중인 이벤트, 기간, 랭킹 종류. 이벤트가 없으면 event는 null입니다.

GET /api/v1/game/records/{region}/events/current

요청 보내기 curl 복사 아직 보내지 않음

이벤트 랭킹

종합 또는 챌린지 곡 랭킹의 상위 100명과 덱.

GET /api/v1/game/records/{region}/events/{eventId}/total/latest

eventId

요청 보내기 curl 복사 아직 보내지 않음

이벤트 포인트 랭킹

포인트를 겨루는 이벤트에는 세 번째 랭킹이 있습니다. 행에는 point가 있고 덱은 없습니다. 다른 이벤트는 404를 반환합니다.

GET /api/v1/game/records/{region}/events/{eventId}/latest

eventId

요청 보내기 curl 복사 아직 보내지 않음

100위 이후

100위씩 읽습니다. start는 해당 창의 시작으로 맞춰지고, maxRank는 마지막 순위가 확인될 때까지 null입니다. search는 플레이어 ID로 상위 2000위를 찾습니다. 창은 이벤트에 포인트 랭킹이 있는 동안만 수집합니다.

GET /api/v1/game/records/{region}/events/{eventId}/points/ranking

eventId start

요청 보내기 curl 복사 아직 보내지 않음

GET /api/v1/game/records/{region}/events/{eventId}/points/search

eventId profileId

요청 보내기 curl 복사 아직 보내지 않음

곡 랭킹

한 곡의 상위 100명.

GET /api/v1/game/records/{region}/songs/{musicId}/ranking

musicId

요청 보내기 curl 복사 아직 보내지 않음

격주 아레나

리그 랭킹을 100행씩. bandId는 리그의 밴드, start는 순위입니다.

GET /api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/ranking

seasonId bandId start

요청 보내기 curl 복사 아직 보내지 않음

포인트 구간별 인원

각 기준점 이상인 플레이어 수를 셉니다. 처음에는 202를 반환하므로 Retry-After초 후 다시 요청하세요.

GET /api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/population

seasonId bandId thresholds

요청 보내기 curl 복사 아직 보내지 않음

플레이어 찾기

상위 searchedTo위 안에서 게임 내 ID를 찾습니다. 범위 밖이면 row는 null입니다.

GET /api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/search

seasonId bandId profileId

요청 보내기 curl 복사 아직 보내지 않음

플레이어

게임에 표시되는 ID로 공개 프로필을 읽습니다.

GET /api/v1/game/records/{region}/players/{profileId}

profileId

요청 보내기 curl 복사 아직 보내지 않음

처음 읽을 때 pending이 올 수 있습니다. 기록은 6시간 후 갱신됩니다.

JavaScript에서

{ "error": { "kind": "pending", "retryAfter": 30 } }