유저 곡별 기록 조회 API

개요

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

인증

없음

API 상세

GET /api/archive/{nickname}/title/{titleNum}

Headers

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

Request Body

없음

params

• nickname : 유저닉네임
• titleNum: 곡 번호
  • 곡 목록 API : https://v-archive.net/db/songs.json

cURL 예제

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

응답

Headers

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

성공

200 OK

{
  "success": true,
  "title": 555,
  "name": "Gloxinia",
  "composer": "Ruxxi, Milkoi",
  "dlcCode": "VE4",
  "dlc": "V EXTENSION 4",
  "patterns": {
    "4B": {
      "HD": {
        "level": 8
      },
      "MX": {
        "level": 11,
        "floor": 4.2
      },
      "NM": {
        "level": 5
      },
      "SC": {
        "level": 11,
        "floor": 11.2,
        "score": "99.57",
        "maxCombo": 1
      }
    },
    "5B": {
      "HD": {
        "level": 9
      },
      "MX": {
        "level": 12,
        "floor": 3.2
      },
      "NM": {
        "level": 7
      },
      "SC": {
        "level": 12,
        "floor": 12.3
      }
    },
 // 길어서 생략
}

patterns 오브젝트

필드	타입	설명
[버튼][패턴]	object	버튼=one of [4B,5B,6B,8B] 패턴=one of ['NM','HD','MX','SC'] 패턴은 있을 때만 존재
[버튼][패턴].score	string	유저 스코어. 기록 있을 때만 존재
[버튼][패턴].maxCombo	number	유저 maxCombo여부 1 or 0. 1이면 맥콤. 기록 있을 때만 존재
[버튼][패턴].level	number	패턴 레벨
[버튼][패턴].floor	number	패턴 층수. 층수 부여되었을 때만 존재
[버튼][패턴].rating	number	레이팅(티어 점수). 층수 부여되었을 때만 존재

실패 - 닉네임 찾지 못함

404 Not Found

{
    "success": false,
    "message": "닉네임 찾을 수 없음"
}

실패 - 곡 찾지 못함

404 Not Found

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

서버 오류

500 Inernal Server Error

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