유저 티어 조회 API

개요

V-ARCHIVE에 저장된 유저별 티어 정보를 버튼 단위로 조회하는 API 입니다.

인증

없음

API 상세

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

Headers

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

Request Body

없음

params

• nickname : 유저닉네임
• button : one of [4, 5, 6, 8]

cURL 예제

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

응답

Headers

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

성공

200 OK

{
  "success": true,
  "top50sum": 8242.1726,
  "tierPoint": 8672.3196,
  "tier": {
    "rating": 8600,
    "name": "Platinum II",
    "code": "PT"
  },
  "next": {
    "rating": 8800,
    "name": "Platinum I",
    "code": "PT"
  },
  "topList": [
    {
      "name": "NB RANGER - Virgin Force",
      "button": 6,
      "pattern": "SC",
      "level": 12,
      "floor": "12.2",
      "maxRating": "180.0",
      "score": "99.82",
      "maxCombo": 1,
      "rating": "174.484"
    },
    // 생략
  ]
}

필드	타입	설명
success	bool	API 성공 여부
top50sum	number	티어 TOP50 포인트 합계
tierPoint	number	티어 환산 포인트
tier	object	현재 티어 정보
next	object	다음 티어 정보
topList	array	티어 Top50 리스트

• 티어 목록 조회 https://v-archive.net/db/tiers.json

실패 - 닉네임 찾지 못함

404 Not Found

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

실패 - 버튼 찾지 못함

404 Not Found

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

실패 - 유저의 티어 정보 없음

404 Not Found

{
    "success": false,
    "message": "{button}버튼 티어 정보 없음"
}

서버 오류

500 Inernal Server Error

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