K리그 API 명세서

GET

/api/comCode.do

특정 공통코드 유형에 속한 세부 코드 리스트를 조회합니다.

요청 파라미터 (Input)

파라미터명	타입(Size)	필수여부	설명
authKey	`varchar`	Y	발급받은 API 인증키
code_type	`numeric(3, 0)`	N	조회할 공통코드 마스터 번호 (예: 4)

응답 필드 명세 (Response Fields)

필드명	데이터 타입	설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지 ("success")
[List] 공통코드 상세 결과 항목 (Result Array)
CODE_TYPE	`numeric(3, 0)`	공통코드 마스터 번호
COM_CODE	`numeric(4, 0)`	공통코드 디테일 값
CODE_NAME	`varchar(40)`	구분코드명
CODE_E_NAME	`varchar(40)`	관리항목1 (정렬순서/기타)
CODE_CLASS	`varchar(40)`	관리항목2 (그룹핑)
SORT_SEQ	`int`	정렬순서
USE_YN	`char(1)`	사용여부 (Y/N)

응답 샘플 (JSON Response)

{
  "response": {
    "resultCode": "00",
    "resultMsg": "success",
    "list": [
      {
        "CODE_TYPE": 4,
        "COM_CODE": 1,
        "CODE_NAME": "방송사",
        "CODE_E_NAME": "1",
        "CODE_CLASS": "BRD",
        "SORT_SEQ": 1,
        "USE_YN": "Y"
      }
    ]
  }
}

호출 샘플 소스 (Sample Code)

Auth: Header or QueryString

인증 로드맵: 현재 authKey 기반 인증을 지원하며, 2027년부터 표준 Bearer Token 인증 체계로 통합 확장될 예정입니다.

OkHttpClient client = new OkHttpClient();

// [방법 1] Query String 방식 (기존 방식)
String url1 = "https://api.kleague.com/api/comCode.do?authKey=YOUR_API_KEY&code_type=4";
Request request1 = new Request.Builder().url(url1).get().build();

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

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

import requests

# [방법 1] Query String 방식 (URL에 직접 포함)
url1 = "https://api.kleague.com/api/comCode.do?authKey=YOUR_API_KEY&code_type=4"
response1 = requests.get(url1)

# [방법 2] Header 인증 방식 (현재 권장)
url2 = "https://api.kleague.com/api/comCode.do"
headers2 = { "authKey": "YOUR_API_KEY" }
params2 = { "code_type": "4" }
response2 = requests.get(url2, headers=headers2, params=params2)

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

// [방법 1] Query String 방식
const url1 = "https://api.kleague.com/api/comCode.do?authKey=YOUR_API_KEY&code_type=4";
axios.get(url1);

// [방법 2] Header 방식 (현재 권장)
axios.get('https://api.kleague.com/api/comCode.do', {
    params: { code_type: '4' },
    headers: { 'authKey': 'YOUR_API_KEY' }
});

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