K리그 API 명세서

GET

/api/stadiumInfo.do

K리그 경기가 열리는 전국의 경기장 위치, 수용 인원 및 주요 사용 구단 정보를 조회합니다.

요청 파라미터 (Request Parameters)

파라미터명	타입(Size)	필수여부	설명
authKey	`varchar`	Y	API 인증키

응답 필드 명세 (Response Fields)

필드명	데이터 타입	설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
apiName	`varchar(30)`	호출된 API 명칭 (stadiumInfo)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지 ("success")
[List] 경기장 상세 정보 항목 (Result Array)
FIELD_ID	`numeric(4, 0)`	경기장 고유 코드
FIELD_NAME	`varchar(20)`	경기장 명칭
FIELD_S_NAME	`varchar(15)`	경기장 약칭
FIELD_ENG_NAME	`varchar(40)`	경기장 영문 명칭
FIELD_FULLNAME	`varchar(50)`	경기장 전체 명칭
FIELD_ADDRESS	`varchar(100)`	경기장 주소
START_DATE	`varchar(10)`	설립일 또는 개장일 (YYYY/MM/DD)
FIELD_CAPA	`int`	수용 인원 (좌석 수)
TEAM_ID	`varchar(3)`	주요 사용 구단 코드
TEAM_S_NAME	`varchar(15)`	구단 명칭 (약칭)
LEAGUE_ID	`numeric(4, 0)`	소속 리그 구분 코드 (공통코드: 84)
LEAGUE_NAME	`varchar(40)`	소속 리그 명칭
USE_YN	`varchar(1)`	사용 여부 (Y/N)

JSON 응답 샘플 (실전 데이터 추출)

{
    "response": {
        "apiName": "stadiumInfo",
        "resultCode": "00",
        "list": [
            {
                "FIELD_ID": 122,
                "FIELD_NAME": "용인 미르",
                "FIELD_S_NAME": "용인M",
                "FIELD_ENG_NAME": "Yongin Mireu Stadium",
                "FIELD_FULLNAME": "용인 미르스타디움",
                "FIELD_ADDRESS": "",
                "START_DATE": "2018/01/01",
                "FIELD_CAPA": 37155,
                "TEAM_ID": "K42",
                "TEAM_S_NAME": "용인",
                "LEAGUE_ID": 0,
                "LEAGUE_NAME": "",
                "USE_YN": "Y"
            },
            {
                "FIELD_ID": 124,
                "FIELD_NAME": "김해 종합",
                "FIELD_S_NAME": "김해",
                "FIELD_ENG_NAME": "Gimhae Stadium",
                "FIELD_FULLNAME": "김해 종합 운동장",
                "FIELD_ADDRESS": "대한민국 경상남도 김해시 가야로 243",
                "START_DATE": "2024/09/11",
                "FIELD_CAPA": 15066,
                "TEAM_ID": "K41",
                "TEAM_S_NAME": "김해",
                "LEAGUE_ID": 0,
                "LEAGUE_NAME": "",
                "USE_YN": "Y"
            }
        ],
        "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/stadiumInfo.do?authKey=YOUR_API_KEY";
Request request1 = new Request.Builder().url(url1).get().build();

// [방법 2] Header 방식 (현재 권장)
Request request2 = new Request.Builder()
  .url("https://api.kleague.com/api/stadiumInfo.do")
  .addHeader("authKey", "YOUR_API_KEY") 
  .build();

// [방법 3] Bearer Token 방식 (2027년 지원 예정)
Request request3 = new Request.Builder()
  .url("https://api.kleague.com/api/stadiumInfo.do")
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN") 
  .build();

import requests

url = "https://api.kleague.com/api/stadiumInfo.do"

# [방법 1] Query String 방식 (URL 직접 호출)
url1 = f"{url}?authKey=YOUR_API_KEY"
response1 = requests.get(url1)

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

# [방법 3] Bearer Token 인증 (2027년 도입 예정)
# headers3 = { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
# response3 = requests.get(url, headers=headers3)

const url = 'https://api.kleague.com/api/stadiumInfo.do';

// [방법 1] Query String 방식
axios.get(`?authKey=YOUR_API_KEY`);

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

// [방법 3] Bearer 방식 (2027년 확장 대응)
// axios.get(url, { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } });