K리그 API 명세서

GET

/api/unOfficialPointByDay.do

설정된 시작일(sdate)부터 종료일(edate)까지의 데이터를 합산하여 선수별 아디다스 포인트 누적치 및 랭킹을 제공합니다.

요청 파라미터 (Request Parameters)

파라미터명	타입(Size)	필수여부	설명
authKey	`varchar`	Y	API 인증키 (Header 전송 권장)
meet_year	`varchar(4)`	Y	대회년도 (예: 2026)
meet_seq	`varchar(2)`	Y	대회순번 (예: 1)
top_rank	`varchar(3)`	Y	출력 제한 상위 순위 (예: 10, 50, 1000 등)
sdate	`varchar(10)`	Y	조회 기준 시작일자 (YYYY/MM/DD)
edate	`varchar(10)`	Y	조회 기준 종료일자 (YYYY/MM/DD)
excludingPO	`varchar(1)`	N	K리그2 플레이오프(PO) 기록 제외 여부 ('Y': 제외, 'N': 포함 - 기본값)

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

필드명	데이터 타입	설명 및 포인트 분류
[Common] 공통 응답 필드 (JSON Header)
meet_year	`varchar(4)`	요청한 대회년도
meet_seq	`varchar(2)`	요청한 대회순번
apiName	`varchar(30)`	호출된 API 명칭 (unOfficialPointByDay)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지 ("success")
[Section 1] 선수 마스터 및 기간 누적 총점
TOT_RANK / GAME_TOT_POINT	`int` / `numeric`	기간 누적 포인트 순위 / 기간 내 포인트 누적 합계
MEET_YEAR / TEAM_ID / ROUND_ID	`varchar(4)` / `varchar(3)` / `int`	대회년도 / 구단 코드 / 라운드 ID (99 고정)
PlAYER_ID / PlAYER_NAME / BACK_NO	`varchar(8)` / `varchar(20)` / `int`	선수 코드 / 선수 성명 / 등번호
[Section 2] 카테고리별 누적 포인트 합계
GAME_ATT_POINT / GAME_PAS_POINT	`numeric`	누적 공격 포인트 / 누적 패스 포인트
GAME_DEF_POINT / GAME_GKD_POINT	`numeric`	누적 수비 포인트 / 누적 수비+골키퍼 포인트
GAME_GKP_POINT / GAME_ETC_POINT	`numeric`	누적 골키퍼 전용 포인트 / 누적 기타 포인트
[Section 3] 공격 세부 누적 포인트 (Attack Detail)
GOAL_POINT / PK_GOAL_POINT / OFF_GOAL_POINT	`numeric`	득점 / PK 득점 / 페널티 박스 밖 득점 포인트
SHOT_ON_TAGET_POINT / DRIBBLE_SUCCESS_POINT	`numeric`	유효슈팅 / 드리블 성공 포인트
PK_MISS_POINT (감점)	`numeric`	PK 실축 감점 포인트
[Section 4] 패스 세부 누적 포인트 (Pass Detail)
ASSIST_POINT / PASS_ACC_POINT	`numeric`	도움(어시스트) / 패스 성공 포인트
KEY_PASS_POINT / CROSS_ACC_POINT	`numeric`	키패스 / 크로스 성공 포인트
[Section 5] 수비 및 골키퍼 세부 누적 포인트 (Defense & GK)
TACKLED_POINT / BLOCKING_BALL_POINT	`numeric`	태클 성공 / 슈팅 블락 포인트
INTERCEPT_POINT / CHALG_GROUND_POINT / CHALG_AIR_POINT	`numeric`	인터셉트 / 지상 경합 성공 / 공중볼 경합 성공 포인트
PK_GIVE_POINT / GOAL_AGAINST_POINT	`numeric`	PK 허용 감점 / 실점 감점 포인트
CLEAN_SHEET_POINT / CLEARING_POINT	`numeric`	클린시트(무실점) / 걷어내기(클리어) 포인트
GK_PUNCH_POINT / GK_CATCH_POINT / GK_AIR_CLEAR_POINT / GK_PK_SAVE_POINT	`numeric`	GK 펀칭 / GK 캐칭 / GK 공중볼 처리 / GK PK 선방 포인트
[Section 6] 기타 결과 및 카드/징계 포인트 (Etc & Discipline)
OWN_GOAL_POINT / WIN_POINT / LOSE_POINT	`numeric`	자책골 감점 / 승리 / 패배 감점 포인트
ACQUIRE_POINT / BALL_MISS_POINT	`numeric`	볼 획득 / 볼 미스 감점 포인트
YELLOW_CARD_POINT / YELLOW_CARD_2_POINT / RED_CARD_POINT	`numeric`	경고 감점 / 경고 누적 퇴장 감점 / 다이렉트 퇴장 감점 포인트

JSON 응답 샘플 (Adidas Accumulation Data)

{
    "response": {
        "meet_year": "2026",
        "apiName": "unOfficialPointByDay",
        "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": 15371,
                "GAME_ATT_POINT": 10490,
                "GAME_PAS_POINT": 724,
                "GAME_DEF_POINT": 3265,
                "GAME_GKD_POINT": 125,
                "GAME_GKP_POINT": 0,
                "GAME_ETC_POINT": 767,
                "GOAL_POINT": 11200,
                "PK_GOAL_POINT": 3850,
                "OFF_GOAL_POINT": 7000,
                "SHOT_ON_TAGET_POINT": 1050,
                "DRIBBLE_SUCCESS_POINT": 560,
                "PK_MISS_POINT": -3150,
                "ASSIST_POINT": 3500,
                "PASS_ACC_POINT": 14,
                "KEY_PASS_POINT": 1050,
                "CROSS_ACC_POINT": 280,
                "TACKLED_POINT": 175,
                "BLOCKING_BALL_POINT": 35,
                "INTERCEPT_POINT": 245,
                "CHALG_GROUND_POINT": 1050,
                "CHALG_AIR_POINT": 70,
                "PK_GIVE_POINT": -7000,
                "GOAL_AGAINST_POINT": 0,
                "CLEAN_SHEET_POINT": 0,
                "CLEARING_POINT": 175,
                "GK_PUNCH_POINT": 0,
                "GK_CATCH_POINT": 0,
                "GK_AIR_CLEAR_POINT": 0,
                "GK_PK_SAVE_POINT": 0,
                "OWN_GOAL_POINT": -10500,
                "WIN_POINT": 2100,
                "LOSE_POINT": -2100,
                "ACQUIRE_POINT": 105,
                "BALL_MISS_POINT": -21,
                "YELLOW_CARD_POINT": -700,
                "YELLOW_CARD_2_POINT": -9800,
                "RED_CARD_POINT": -10500
            },
            {
                "TOT_RANK": 2,
                "MEET_YEAR": "2026",
                "TEAM_ID": "K18",
                "PlAYER_ID": "20180196",
                "PlAYER_NAME": "무고사",
                "BACK_NO": 9,
                "ROUND_ID": 99,
                "GAME_TOT_POINT": 13260,
                "GAME_ATT_POINT": 10990,
                "GAME_PAS_POINT": 1574,
                "GAME_DEF_POINT": 945,
                "GAME_GKD_POINT": 25,
                "GAME_GKP_POINT": 0,
                "GAME_ETC_POINT": -274,
                "GOAL_POINT": 11200,
                "PK_GOAL_POINT": 3850,
                "OFF_GOAL_POINT": 7000,
                "SHOT_ON_TAGET_POINT": 1050,
                "DRIBBLE_SUCCESS_POINT": 560,
                "PK_MISS_POINT": -3150,
                "ASSIST_POINT": 3500,
                "PASS_ACC_POINT": 14,
                "KEY_PASS_POINT": 1050,
                "CROSS_ACC_POINT": 280,
                "TACKLED_POINT": 175,
                "BLOCKING_BALL_POINT": 35,
                "INTERCEPT_POINT": 245,
                "CHALG_GROUND_POINT": 1050,
                "CHALG_AIR_POINT": 70,
                "PK_GIVE_POINT": -7000,
                "GOAL_AGAINST_POINT": 0,
                "CLEAN_SHEET_POINT": 0,
                "CLEARING_POINT": 175,
                "GK_PUNCH_POINT": 0,
                "GK_CATCH_POINT": 0,
                "GK_AIR_CLEAR_POINT": 0,
                "GK_PK_SAVE_POINT": 0,
                "OWN_GOAL_POINT": -10500,
                "WIN_POINT": 2100,
                "LOSE_POINT": -2100,
                "ACQUIRE_POINT": 105,
                "BALL_MISS_POINT": -21,
                "YELLOW_CARD_POINT": -700,
                "YELLOW_CARD_2_POINT": -9800,
                "RED_CARD_POINT": -10500
            }
        ],
        "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/unOfficialPointByDay.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&top_rank=50&sdate=2026/01/01&edate=2026/12/31&excludingPO=Y";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/unOfficialPointByDay.do?meet_year=2026&meet_seq=1&top_rank=50&sdate=2026/01/01&edate=2026/12/31&excludingPO=Y";
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/unOfficialPointByDay.do"
params = { 
    "meet_year": "2026", 
    "meet_seq": "1", 
    "top_rank": "50",
    "sdate": "2026/01/01",
    "edate": "2026/12/31",
    "excludingPO": "Y"
}

# [방법 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/unOfficialPointByDay.do';
const params = { 
    meet_year: '2026', 
    meet_seq: '1', 
    top_rank: '50', 
    sdate: '2026/01/01', 
    edate: '2026/12/31', 
    excludingPO: 'Y' 
};

// [방법 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' } });