유저 성과표 조회 API

개요

V-ARCHIVE에 저장된 유저별 기록을 성과표 단위로 조회하는 API 입니다.

인증

없음

API 상세

GET /api/archive/{nickname}/board/{button}/{board}

Headers

key	필수여부	값
Content-Type	Y	application/json

Request Body

없음

params

• nickname : 유저닉네임
• button : one of [4, 5, 6, 8]
• board : one of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, MX, SC, SC5, SC10, SC15]
  • board 목록 API : https://v-archive.net/db/boards.json

cURL 예제

curl --location --request GET 'https://v-archive.net/api/archive/%EB%82%B4%EA%BA%BC/board/6/MX' --header 'Content-Type: application/json'

응답

Headers

• Content-Type: application/json; charset=utf-8

성공

200 OK

{
    "success": true,
    "board": "MX",
    "button": "6",
    "totalCount": 307,
    "floors": [
        {
            "floorNumber": 11.3,
            "patterns": [
                {
                    "title": 46,
                    "name": "We're All Gonna Die",
                    "composer": "Paul Bazooka",
                    "pattern": "MX",
                    "score": "99.51",
                    "maxCombo": 1,
                    "rating": 165.988,
                    "dlc": "RESPECT",
                    "dlcCode": "R"
                }
            ]
        },
        {
            "floorNumber": 11.2,
            "patterns": [
                {
                    "title": 290,
                    "name": "L",
                    "composer": "Ice",
                    "pattern": "MX",
                    "score": "99.57",
                    "maxCombo": 1,
                    "rating": 163.365,
                    "dlc": "COLLABORATION",
                    "dlcCode": "CY"
                },
                {
                    "title": 544,
                    "name": "LIMBO",
                    "composer": "Mori+",
                    "pattern": "MX",
                    "score": "99.72",
                    "maxCombo": 1,
                    "rating": 166.395,
                    "dlc": "COLLABORATION",
                    "dlcCode": "EZ2"
                },
            //...길어서 생략
            ]
        }
    //...길어서 생략
    ]
}

floor 오브젝트

필드	타입	설명
floorNumber	number	층 수. '미분류' 층은 0. "SC"성과표는 레벨=층
patterns	pattern[]	해당 층의 패턴 리스트

pattern 오브젝트

필드	타입	설명
title	number	곡ID
name	string	곡 제목
composer	string	작곡가
pattern	string	'NM', 'HD', 'MX', 'SC' 중 하나
score	string	유저 스코어. 기록 없으면 null
maxCombo	number	유저 maxCombo여부 1 or 0. 1이면 맥콤. 기록 없으면 null
rating	number	유저 레이팅(티어점수). 기록 없으면 0
dlc	string	dlc명. 콜라보DLC는 'COLLABORATION'
dlcCode	string	dlc코드

실패 - 닉네임 찾지 못함

404 Not Found

{
    "success": false,
    "message": "{nickname} 찾을 수 없음"
}

실패 - 성과표 찾지 못함

404 Not Found

{
    "success": false,
    "message": "성과표 찾을 수 없음"
}

서버 오류

500 Inernal Server Error

{
    "message": "오류 내용"
}