대회 일정 (Match Schedule)
GET
/api/meetSchedule.do
특정 시즌 및 대회(리그)의 전체 경기 일정과 대진표 정보를 조회합니다.
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 |
| meet_year | varchar(4) |
Y | 대회년도 (예: 2026) |
| meet_seq | numeric(2, 0) |
Y | 대회순번 (1:K리그1, 2:K리그2 등) |
응답 필드 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | numeric(2, 0) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (meetSchedule) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [List] 경기 일정 상세 정보 항목 (Result Array) | ||
| MEET_YEAR | varchar(4) | 대회년도 |
| MEET_SEQ | numeric(2, 0) | 대회순번 |
| GAME_ID | numeric(3, 0) | 경기 고유 번호 |
| ROUND_ID | int | 경기 라운드 (회차) |
| HOME_TEAM | varchar(3) | 홈 팀 구단 코드 |
| HOME_TEAM_NAME | varchar(20) | 홈 팀 명칭 |
| AWAY_TEAM | varchar(3) | 어웨이 팀 구단 코드 |
| AWAY_TEAM_NAME | varchar(20) | 어웨이 팀 명칭 |
| FIELD_ID | numeric(4, 0) | 구장코드 |
| FIELD_NAME | varchar(20) | 경기장 명칭 |
| GAME_DATE | varchar(10) | 경기 일자 (YYYY/MM/DD) |
| GAME_TIME | varchar(5) | 경기 시각 (HH:mm) |
| GAME_DAY | varchar(10) | 요일 (한글: 일, 월, 화 등) |
| GAME_TYPE | numeric(4, 0) | 경기 구분 코드 (공통코드:38) |
| GAME_TYPE_NAME | varchar(40) | 경기 구분 명칭 (예: 정규리그, 파이널A 등) |
| NEUTRAL_YN | varchar(1) | 중립 지역 여부 (Y/N) |
| END_YN | char(1) | 경기 종료 여부 (Y/N) |
| REC_SUM_YN | varchar(1) | 기록 합산 여부 (Y/N) |
| AUDIENCE_YN | varchar(1) | 관중수 합산 여부 (Y/N) |
| POINT_SUM_YN | varchar(1) | 승점 합산 여부 (Y/N) |
JSON 응답 샘플 (2026 실전 데이터)
{
"response": {
"meet_year": "2026",
"apiName": "meetSchedule",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"GAME_ID": 227,
"ROUND_ID": 38,
"HOME_TEAM": "K35",
"HOME_TEAM_NAME": "김천",
"AWAY_TEAM": "K10",
"AWAY_TEAM_NAME": "대전",
"FIELD_ID": 105,
"FIELD_NAME": "김천 종합",
"GAME_DATE": "2026/11/29",
"GAME_TIME": "16:30",
"GAME_TYPE": 1,
"GAME_TYPE_NAME": "파이널A",
"END_YN": "Y",
"GAME_DAY": "일"
},
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"GAME_ID": 228,
"ROUND_ID": 38,
"HOME_TEAM": "K21",
"HOME_TEAM_NAME": "강원",
"AWAY_TEAM": "K03",
"AWAY_TEAM_NAME": "포항",
"FIELD_ID": 112,
"FIELD_NAME": "강릉하이원아레나",
"GAME_DATE": "2026/11/29",
"GAME_TIME": "16:30",
"GAME_TYPE": 1,
"GAME_TYPE_NAME": "파이널A",
"END_YN": "Y",
"GAME_DAY": "일"
}
],
"resultMsg": "success"
}
}
호출 샘플 소스 (Sample Code)
Auth: Header or QueryString
인증 로드맵: 현재
authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다.
OkHttpClient client = new OkHttpClient();
// [방법 1] Query String 방식 (전체 파라미터 URL 포함)
String url1 = "https://api.kleague.com/api/meetSchedule.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/meetSchedule.do?meet_year=2026&meet_seq=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/meetSchedule.do"
params = {
"meet_year": "2026",
"meet_seq": "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/meetSchedule.do';
const params = { meet_year: '2026', meet_seq: '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' } });