아디다스 포인트 조회 (Adidas Point by Round)

GET

/api/unOfficialPointByRound.do

입력된 라운드를 기준으로 최근 5개 라운드의 데이터를 가중 합산하여 선수별 아디다스 포인트 상세 항목 및 랭킹을 제공합니다.

요청 파라미터 (Request Parameters)

파라미터명 타입(Size) 필수여부 설명
authKey varchar Y API 인증키 (Header 전송 권장)
meet_year varchar(4) Y 대회년도 (예: 2026)
meet_seq varchar(2) Y 대회순번 (예: 1)
round_id varchar(3) Y 기준 라운드 ID (예: 34)
top_rank varchar(3) Y 출력 제한 상위 순위 (예: 10, 30, 50 등)

응답 필드 상세 명세 (Response Fields)

필드명 데이터 타입 설명 및 포인트 분류
[Common] 공통 응답 필드 (JSON Header)
meet_yearvarchar(4)요청한 대회년도
meet_seqvarchar(2)요청한 대회순번
apiNamevarchar(30)호출된 API 명칭 (unOfficialPointByRound)
resultCode varchar(3) 결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsgvarchar(100)결과 메시지 ("success")
[Section 1] 선수 기본 정보 및 총점/순위
TOT_RANK / GAME_TOT_POINTint / numeric전체 포인트 순위 / 최근 5라운드 가중 합산 총점
MEET_YEAR / TEAM_ID / ROUND_IDvarchar(4) / varchar(3) / int대회년도 / 구단 코드 / 라운드 ID (99 고정)
PlAYER_ID / PlAYER_NAME / BACK_NOvarchar(8) / varchar(20) / int선수 코드 / 선수 성명 / 등번호
[Section 2] 영역별 포인트 합계 (Category Sum)
GAME_ATT_POINT / GAME_PAS_POINTnumeric공격 포인트 합산 / 패스 포인트 합산
GAME_DEF_POINT / GAME_GKD_POINTnumeric수비 포인트 합산 / 수비+골키퍼 포인트 합산
GAME_GKP_POINT / GAME_ETC_POINTnumeric골키퍼 전용 포인트 합산 / 기타 포인트 합산
[Section 3] 공격 세부 포인트 (Attack Detail)
GOAL_POINT / PK_GOAL_POINT / OFF_GOAL_POINTnumeric득점 / PK 득점 / 페널티 박스 밖 득점 포인트
SHOT_ON_TAGET_POINT / DRIBBLE_SUCCESS_POINTnumeric유효슈팅 / 드리블 성공 포인트
PK_MISS_POINT (감점)numericPK 실축 감점 포인트
[Section 4] 패스 세부 포인트 (Pass Detail)
ASSIST_POINT / PASS_ACC_POINTnumeric도움(어시스트) / 패스 성공 포인트
KEY_PASS_POINT / CROSS_ACC_POINTnumeric키패스 / 크로스 성공 포인트
[Section 5] 수비 및 골키퍼 세부 포인트 (Defense & GK)
TACKLED_POINT / BLOCKING_BALL_POINTnumeric태클 성공 / 슈팅 블락 포인트
INTERCEPT_POINT / CHALG_GROUND_POINT / CHALG_AIR_POINTnumeric인터셉트 / 지상 경합 성공 / 공중볼 경합 성공 포인트
PK_GIVE_POINT / GOAL_AGAINST_POINTnumericPK 허용 감점 / 실점 감점 포인트
CLEAN_SHEET_POINT / CLEARING_POINTnumeric클린시트(무실점) / 걷어내기(클리어) 포인트
GK_PUNCH_POINT / GK_CATCH_POINT / GK_AIR_CLEAR_POINT / GK_PK_SAVE_POINTnumericGK 펀칭 / GK 캐칭 / GK 공중볼 처리 / GK PK 선방 포인트
[Section 6] 기타 결과 및 카드/징계 포인트 (Etc & Discipline)
OWN_GOAL_POINT / WIN_POINT / LOSE_POINTnumeric자책골 감점 / 승리 / 패배 감점 포인트
ACQUIRE_POINT / BALL_MISS_POINTnumeric볼 획득 / 볼 미스 감점 포인트
YELLOW_CARD_POINT / YELLOW_CARD_2_POINT / RED_CARD_POINTnumeric경고 감점 / 경고 누적 퇴장 감점 / 다이렉트 퇴장 감점 포인트

JSON 응답 샘플 (Adidas Point Data) 

{
    "response": {
        "meet_year": "2026",
        "apiName": "unOfficialPointByRound",
        "resultCode": "00",
        "meet_seq": "1",
        "list": [
            {
                "TOT_RANK": 1,
                "MEET_YEAR": "2026",
                "TEAM_ID": "K01",
                "PlAYER_ID": "20230315",
                "PlAYER_NAME": "야고",
                "BACK_NO": 99,
                "ROUND_ID": 99,
                "GAME_TOT_POINT": 4823.0,
                "GAME_ATT_POINT": 3650.0,
                "GAME_PAS_POINT": 164.0,
                "GAME_DEF_POINT": 605.0,
                "GAME_GKD_POINT": 50.0,
                "GAME_GKP_POINT": 0.0,
                "GAME_ETC_POINT": 354.0,
                "GOAL_POINT": 3200.0,
                "PK_GOAL_POINT": 0.0,
                "OFF_GOAL_POINT": 0.0,
                "SHOT_ON_TAGET_POINT": 450.0,
                "DRIBBLE_SUCCESS_POINT": 0.0,
                "PK_MISS_POINT": 0.0,
                "ASSIST_POINT": 0.0,
                "PASS_ACC_POINT": 14.0,
                "KEY_PASS_POINT": 150.0,
                "CROSS_ACC_POINT": 0.0,
                "TACKLED_POINT": 50.0,
                "BLOCKING_BALL_POINT": 5.0,
                "INTERCEPT_POINT": 70.0,
                "CHALG_GROUND_POINT": 450.0,
                "CHALG_AIR_POINT": 30.0,
                "PK_GIVE_POINT": 0.0,
                "GOAL_AGAINST_POINT": 0.0,
                "CLEAN_SHEET_POINT": 0.0,
                "CLEARING_POINT": 50.0,
                "GK_PUNCH_POINT": 0.0,
                "GK_CATCH_POINT": 0.0,
                "GK_AIR_CLEAR_POINT": 0.0,
                "GK_PK_SAVE_POINT": 0.0,
                "OWN_GOAL_POINT": 0.0,
                "WIN_POINT": 300.0,
                "LOSE_POINT": 0.0,
                "ACQUIRE_POINT": 60.0,
                "BALL_MISS_POINT": -6.0,
                "YELLOW_CARD_POINT": 0.0,
                "YELLOW_CARD_2_POINT": 0.0,
                "RED_CARD_POINT": 0.0
            },
            {
                "TOT_RANK": 2,
                "MEET_YEAR": "2026",
                "TEAM_ID": "K26",
                "PlAYER_ID": "20220353",
                "PlAYER_NAME": "갈레고",
                "BACK_NO": 11,
                "ROUND_ID": 99,
                "GAME_TOT_POINT": 3676.0,
                "GAME_ATT_POINT": 2610.0,
                "GAME_PAS_POINT": 672.0,
                "GAME_DEF_POINT": 40.0,
                "GAME_GKD_POINT": 0.0,
                "GAME_GKP_POINT": 0.0,
                "GAME_ETC_POINT": 354.0,
                "GOAL_POINT": 1600.0,
                "PK_GOAL_POINT": 550.0,
                "OFF_GOAL_POINT": 0.0,
                "SHOT_ON_TAGET_POINT": 300.0,
                "DRIBBLE_SUCCESS_POINT": 160.0,
                "PK_MISS_POINT": 0.0,
                "ASSIST_POINT": 500.0,
                "PASS_ACC_POINT": 22.0,
                "KEY_PASS_POINT": 150.0,
                "CROSS_ACC_POINT": 0.0,
                "TACKLED_POINT": 0.0,
                "BLOCKING_BALL_POINT": 5.0,
                "INTERCEPT_POINT": 35.0,
                "CHALG_GROUND_POINT": 0.0,
                "CHALG_AIR_POINT": 0.0,
                "PK_GIVE_POINT": 0.0,
                "GOAL_AGAINST_POINT": 0.0,
                "CLEAN_SHEET_POINT": 0.0,
                "CLEARING_POINT": 0.0,
                "GK_PUNCH_POINT": 0.0,
                "GK_CATCH_POINT": 0.0,
                "GK_AIR_CLEAR_POINT": 0.0,
                "GK_PK_SAVE_POINT": 0.0,
                "OWN_GOAL_POINT": 0.0,
                "WIN_POINT": 300.0,
                "LOSE_POINT": 0.0,
                "ACQUIRE_POINT": 60.0,
                "BALL_MISS_POINT": -6.0,
                "YELLOW_CARD_POINT": 0.0,
                "YELLOW_CARD_2_POINT": 0.0,
                "RED_CARD_POINT": 0.0
            }
        ],
        "resultMsg": "success"
    }
}

호출 샘플 소스 (Sample Code)

Auth: Header or QueryString
인증 로드맵: 현재 authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다. 
OkHttpClient client = new OkHttpClient();

// [방법 1] Query String 방식
String url1 = "https://api.kleague.com/api/unOfficialPointByRound.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&round_id=34&top_rank=10";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/unOfficialPointByRound.do?meet_year=2026&meet_seq=1&round_id=34&top_rank=10";
Request request2 = new Request.Builder()
  .url(url2)
  .addHeader("authKey", "YOUR_API_KEY") 
  .build();

// [방법 3] Bearer Token 방식 (2027년 지원 예정)
Request request3 = new Request.Builder()
  .url(url2)
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN") 
  .build();
import requests

url = "https://api.kleague.com/api/unOfficialPointByRound.do"
params = { 
    "meet_year": "2026", 
    "meet_seq": "1", 
    "round_id": "34",
    "top_rank": "10"
}

# [방법 1] Query String 방식
response1 = requests.get(url, params={**params, "authKey": "YOUR_API_KEY"})

# [방법 2] Header 인증 방식 (현재 추천)
headers2 = { "authKey": "YOUR_API_KEY" }
response2 = requests.get(url, headers=headers2, params=params)

# [방법 3] Bearer Token 방식 (2027년 도입 예정)
# headers3 = { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
# response3 = requests.get(url, headers=headers3, params=params)
const url = 'https://api.kleague.com/api/unOfficialPointByRound.do';
const params = { meet_year: '2026', meet_seq: '1', round_id: '34', top_rank: '10' };

// [방법 1] Query String 방식
axios.get(url, { params: { ...params, authKey: 'YOUR_API_KEY' } });

// [방법 2] Header 방식 (현재 권장)
axios.get(url, {
    params: params,
    headers: { 'authKey': 'YOUR_API_KEY' }
});

// [방법 3] Bearer 방식 (2027년 로드맵 대비)
// axios.get(url, { params: params, headers: { 'Authorization': 'Bearer YOUR_TOKEN' } });