K리그 API 명세서

GET

/api/codeType.do

K LEAGUE 시스템에서 정의된 모든 공통코드 유형(Group) 목록을 조회합니다.

요청 파라미터 (Input)

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

응답 필드 명세 (Response Fields)

필드명	데이터 타입	설명 및 비고
[Common] 공통 응답 필드 (JSON Header)
resultCode	`varchar(3)`	결과 코드 (00: 성공, 그 외 에러는 API 개요 참조)
resultMsg	`varchar(100)`	결과 메시지 ("success")
[List] 공통코드 마스터 결과 항목 (Result Array)
CODE_TYPE	`numeric(3, 0)`	공통코드 마스터 번호
TYPE_NAME	`varchar(30)`	공통코드 유형 명칭
USE_YN	`char(1)`	사용여부 (Y/N)

응답 샘플 (JSON Response)

{
  "response": {
    "resultCode": "00",
    "resultMsg": "success",
    "list": [
      {
        "CODE_TYPE": 4,
        "TYPE_NAME": "매체사 구분",
        "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/codeType.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/codeType.do")
  .addHeader("authKey", "YOUR_API_KEY") 
  .build();

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

import requests

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

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

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

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

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

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