경기 일반 정보 (Match Info)
시간대별 필드 구분 규칙 (Time Prefix Guide)
본 명세서의 상세 시간 관련 필드에 사용되는 접두어(Prefix)는 다음과 같습니다.
B_ (전반전)
A_ (후반전)
EB_ (연장전반)
EA_ (연장후반)
GET
/api/matchInfo.do
특정 경기의 마스터 정보(날씨, 관중, 심판, MOM, 유니폼 색상 등)를 종합 조회합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 (Header 전송 권장) |
| meet_year | varchar(4) |
Y | 조회 대상 대회년도 (예: 2026) |
| meet_seq | varchar(4) |
Y | 대회순번 (1: K리그1, 2: K리그2 등) |
| game_id | varchar(4) |
Y | 해당 대회의 경기 고유 번호 (Game ID) |
응답 필드 명세 (Full Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | varchar(4) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (matchInfo) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [Section 1] 경기 마스터 및 팀 기본 정보 | ||
| MEET_YEAR / MEET_SEQ / GAME_ID | varchar(4) / numeric(2,0) / numeric(3,0) | 대회년도 / 대회순번 / 경기번호 |
| MEET_NAME_KOR / MEET_NAME_ENG | varchar(50) | 대회 한글명 / 대회 영문명 |
| LEAGUE_ID / LEAGUE_NAME | numeric(4,0) / varchar(40) | 리그 코드 (공통코드:84) / 리그 명칭 |
| GAME_TYPE / GAME_TYPE_NAME | numeric(4,0) / varchar(40) | 경기 구분 코드 (공통코드:38) / 구분명 (정규리그, 스플릿 등) |
| ROUND_ID | int | 경기 라운드 (회차) |
| GAME_DATE / GAME_TIME | varchar(10) / varchar(8) | 경기일자 (YYYY/MM/DD) / 경기시각 (HH:MI) |
| HOME_TEAM_ID / HOME_TEAM_NAME / HOME_TEAM_NAME_ENG | varchar(3) / varchar(20) / varchar(30) | 홈팀 코드 / 홈팀 한글명 / 홈팀 영문명 |
| HOME_GAIN_GOAL | int | 홈팀 총 득점 수 |
| AWAY_TEAM_ID / AWAY_TEAM_NAME / AWAY_TEAM_NAME_ENG | varchar(3) / varchar(20) / varchar(30) | 어웨이팀 코드 / 어웨이팀 한글명 / 어웨이팀 영문명 |
| AWAY_GAIN_GOAL | int | 어웨이팀 총 득점 수 |
| FIELD_ID / FIELD_NAME / FIELD_NAME_ENG | numeric(4,0) / varchar(20) / varchar(40) | 구장 코드 / 경기장 한글명 / 경기장 영문명 |
| AUDIANCE_QTY | int | 경기 최종 관중 수 |
| WEATHER_NAME / TEMPERATURE / HUMIDITY | varchar(40) / numeric(4,1) / numeric(3,0) | 날씨명 / 온도 (℃) / 습도 (%) |
| [Section 2] 심판진 및 경기 관계자 정보 (Referees & Officials) | ||
| REFREE_ID1 / REFREE_NAME1 / REFREE_NAME1_ENG | varchar(8) / varchar(20) / varchar(50) | 주심 코드 / 한글 성명 / 영문 풀네임 |
| REFREE_ID2 / REFREE_NAME2 / REFREE_NAME2_ENG | varchar(8) / varchar(20) / varchar(50) | 부심 1 코드 / 한글 성명 / 영문 풀네임 |
| REFREE_ID3 / REFREE_NAME3 / REFREE_NAME3_ENG | varchar(8) / varchar(20) / varchar(50) | 부심 2 코드 / 한글 성명 / 영문 풀네임 |
| REFREE_ID4 / REFREE_NAME4 / REFREE_NAME4_ENG | varchar(8) / varchar(20) / varchar(50) | 대기심 코드 / 한글 성명 / 영문 풀네임 |
| INSPECTOR_ID1 / INSPECTOR_NAME1 / INSPECTOR_NAME1_ENG | varchar(8) / varchar(20) / varchar(50) | 경기 감독관 코드 / 한글 성명 / 영문 풀네임 |
| INSPECTOR_ID2 / INSPECTOR_NAME2 / INSPECTOR_NAME2_ENG | varchar(8) / varchar(20) / varchar(50) | 심판 감독관 코드 / 한글 성명 / 영문 풀네임 |
| RECORDER | varchar(10) | 경기 공식 기록원 성명 |
| [Section 3] MOM (Man of the Match) 정보 | ||
| MOM_TEAM_ID / MOM_TEAM_NAME / MOM_TEAM_NAME_ENG | varchar(3) / varchar(15) / varchar(30) | MOM 선정 선수 소속팀 코드 / 팀 약칭 / 팀 영문명 |
| MOM_PLAYER_ID / MOM_PLAYER_NAME / MOM_PLAYER_NAME_ENG | varchar(8) / varchar(20) / varchar(50) | MOM 선수 코드 / 선수 한글명 / 선수 영문 풀네임 |
| [Section 4] 전/후반 시간 기록 및 유니폼 색상 | ||
| B_STIME / B_ETIME / B_DIFF_TIME / B_RESTMIN | varchar(5) / int | 전반 시작시각 / 전반 종료시각 / 전반 소요시간(분) / 휴식시간(분) |
| A_STIME / A_ETIME / A_DIFF_TIME / A_RESTMIN | varchar(5) / int | 후반 시작시각 / 후반 종료시각 / 후반 소요시간(분) / 휴식시간(분) |
| EB_STIME / EB_ETIME / EB_DIFF_TIME / EB_RESTMIN | varchar(5) / int | 연장전반 시작시각 / 종료시각 / 소요시간(분) / 휴식시간(분) |
| EA_STIME / EA_ETIME / EA_DIFF_TIME / RUNMIN | varchar(5) / int | 연장후반 시작시각 / 종료시각 / 소요시간(분) / 총 경기 진행시간(분) |
| H_JCOLOR_KOR / H_TCOLOR_KOR / H_SOCCOLOR_KOR | varchar(20) | 홈팀 상의 색상 / 하의 색상 / 양말 색상 |
| A_JCOLOR_KOR / A_TCOLOR_KOR / A_SOCCOLOR_KOR | varchar(20) | 어웨이팀 상의 색상 / 하의 색상 / 양말 색상 |
| [Section 5] 기타 설정, 마감 및 승부차기 | ||
| NEUTRAL_YN / END_YN | varchar(1) / char(1) | 중립 지역 여부 (Y/N) / 경기 마감 여부 (Y/N) |
| REC_SUM_YN / AUDIENCE_YN / POINT_SUM_YN | varchar(1) | 기록 반영 여부 / 관중수 반영 여부 / 승점 반영 여부 (Y/N) |
| HOME_TK_GOAL / AWAY_TK_GOAL | int | 홈팀 승부차기 성공 득점 / 어웨이팀 승부차기 성공 득점 |
JSON 응답 샘플 (Full Detail)
{
"response": {
"meet_year": "2026",
"apiName": "matchInfo",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"MEET_NAME_KOR": "하나은행 K리그1 2026",
"MEET_NAME_ENG": "K league 1 2026",
"LEAGUE_ID": 2,
"LEAGUE_NAME": "K리그1",
"GAME_ID": 1,
"GAME_TYPE": 21,
"GAME_TYPE_NAME": "스플릿일반",
"ROUND_ID": 1,
"HOME_TEAM_ID": "K18",
"HOME_TEAM_NAME": "인천",
"HOME_TEAM_NAME_ENG": "INCHEON",
"HOME_GAIN_GOAL": 1,
"AWAY_TEAM_ID": "K09",
"AWAY_TEAM_NAME": "서울",
"AWAY_TEAM_NAME_ENG": "SEOUL",
"AWAY_GAIN_GOAL": 2,
"FIELD_ID": 95,
"FIELD_NAME": "인천 전용",
"FIELD_NAME_ENG": "Incheon Football",
"AUDIANCE_QTY": 18108,
"GAME_DATE": "2026/02/28",
"GAME_TIME": "14:00",
"WEATHER_NAME": "맑음",
"REFREE_ID1": "19100232",
"REFREE_NAME1": "이동준",
"REFREE_NAME1_ENG": "Lee Dong-Jun",
"REFREE_ID2": "19100238",
"REFREE_NAME2": "윤재열",
"REFREE_NAME2_ENG": "Yun Jae-Yeol",
"REFREE_ID3": "20150237",
"REFREE_NAME3": "김지욱",
"REFREE_NAME3_ENG": "Kim Ji-Uk",
"REFREE_ID4": "19100234",
"REFREE_NAME4": "송민석",
"REFREE_NAME4_ENG": "Song Min-Seok",
"INSPECTOR_ID1": "19970113",
"INSPECTOR_NAME1": "허기태",
"INSPECTOR_NAME1_ENG": "Huh, Ki Tae",
"INSPECTOR_ID2": "",
"INSPECTOR_NAME2": "",
"INSPECTOR_NAME2_ENG": "",
"RECORDER": "도지환",
"MOM_TEAM_ID": "K09",
"MOM_TEAM_NAME": "서울",
"MOM_TEAM_NAME_ENG": "SEOUL",
"MOM_PLAYER_ID": "20180034",
"MOM_PLAYER_NAME": "송민규",
"MOM_PLAYER_NAME_ENG": "Minkyu SONG",
"B_STIME": "14:00",
"B_ETIME": "14:55",
"A_STIME": "15:10",
"A_ETIME": "16:06",
"EB_STIME": "",
"EB_ETIME": "",
"EA_STIME": "",
"EA_ETIME": "",
"B_DIFF_TIME": 55,
"A_DIFF_TIME": 56,
"EB_DIFF_TIME": 0,
"EA_DIFF_TIME": 0,
"RESTMIN": 15,
"RUNMIN": 111,
"B_RESTMIN": 15,
"A_RESTMIN": 0,
"EB_RESTMIN": 0,
"H_JCOLOR_KOR": "파/검",
"H_TCOLOR_KOR": "검정",
"H_SOCCOLOR_KOR": "검정",
"A_JCOLOR_KOR": "흰색",
"A_TCOLOR_KOR": "흰색",
"A_SOCCOLOR_KOR": "흰색",
"TEMPERATURE": 11.0,
"HUMIDITY": 40,
"NEUTRAL_YN": "N",
"REC_SUM_YN": "Y",
"AUDIENCE_YN": "Y",
"POINT_SUM_YN": "Y",
"END_YN": "Y",
"HOME_TK_GOAL": 0,
"AWAY_TK_GOAL": 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/matchInfo.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&game_id=1";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/matchInfo.do?meet_year=2026&meet_seq=1&game_id=1";
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/matchInfo.do"
params = {
"meet_year": "2026",
"meet_seq": "1",
"game_id": "1"
}
# [방법 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/matchInfo.do';
const params = { meet_year: '2026', meet_seq: '1', game_id: '1' };
// [방법 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' } });