패스 매트릭스 조회 (Pass Matrix Record)
GET
/api/unOfficialMatchPassMatrixRecord.do
특정 경기의 팀별 선수 간 패스 성공 횟수를 집계하여 제공합니다. (누가 누구에게 몇 번의 패스를 성공했는지 확인 가능)
요청 파라미터 (Request Parameters)
| 파라미터명 | 타입(Size) | 필수여부 | 설명 |
|---|---|---|---|
| authKey | varchar |
Y | API 인증키 (Header 전송 권장) |
| meet_year | varchar(4) |
Y | 대회년도 (예: 2026) |
| meet_seq | varchar(2) |
Y | 대회순번 (예: 1) |
| team_id | varchar(3) |
Y | 구단 코드 (예: K05) |
| game_id | varchar(3) |
Y | 경기번호 (예: 1) |
응답 필드 상세 명세 (Response Fields)
| 필드명 | 데이터 타입 | 설명 및 비고 |
|---|---|---|
| [Common] 공통 응답 필드 (JSON Header) | ||
| meet_year | varchar(4) | 요청한 대회년도 |
| meet_seq | varchar(2) | 요청한 대회순번 |
| apiName | varchar(30) | 호출된 API 명칭 (unOfficialMatchPassMatrixRecord) |
| resultCode | varchar(3) |
결과 코드 (00: 성공, 그 외 에러는 API 개요 참조) |
| resultMsg | varchar(100) | 결과 메시지 ("success") |
| [Section 1] 경기 및 구단 기본 정보 | ||
| MEET_YEAR / MEET_SEQ / GAME_ID | varchar(4) / numeric(2,0) / varchar(3) | 대회년도 / 대회순번 / 경기번호 |
| TEAM_ID | varchar(3) | 구단 코드 |
| [Section 2] 패스 시도 선수 정보 (Passer) | ||
| PLAYER_ID / PLAYER_NM | varchar(8) / varchar(20) | 패스를 보낸 선수 코드 / 성명 |
| PLAYER_POSITION_CD / PLAYER_POSITION_NM | numeric(4,0) / varchar(40) | 패스 보낸 선수 포지션 코드 / 포지션명 (공통코드:42) |
| [Section 3] 패스 수신 선수 정보 (Receiver) | ||
| PLAYER_ID_RECEIVED / PLAYER_ID_RECEIVED_NM | varchar(8) / varchar(20) | 패스를 받은 선수 코드 / 성명 |
| PLAYER_RECEIVED_POSITION_CD / PLAYER_RECEIVED_POSITION_NM | numeric(4,0) / varchar(40) | 패스 받은 선수 포지션 코드 / 포지션명 (공통코드:42) |
| [Section 4] 패스 성공 통계 데이터 | ||
| PASS_COUNT | numeric | 두 선수 간 패스 성공 횟수 |
JSON 응답 샘플 (Pass Matrix Data)
{
"response": {
"meet_year": "2026",
"apiName": "unOfficialMatchPassMatrixRecord",
"resultCode": "00",
"meet_seq": "1",
"list": [
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"GAME_ID": "1",
"TEAM_ID": "K05",
"PLAYER_ID": "20180025",
"PLAYER_NM": "송범근",
"PLAYER_POSITION_CD": 1,
"PLAYER_POSITION_NM": "GK",
"PLAYER_ID_RECEIVED": "20100163",
"PLAYER_ID_RECEIVED_NM": "홍정호",
"PLAYER_RECEIVED_POSITION_CD": 2,
"PLAYER_RECEIVED_POSITION_NM": "DF",
"PASS_COUNT": 5
},
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"GAME_ID": "1",
"TEAM_ID": "K05",
"PLAYER_ID": "20180025",
"PLAYER_NM": "송범근",
"PLAYER_POSITION_CD": 1,
"PLAYER_POSITION_NM": "GK",
"PLAYER_ID_RECEIVED": "20110035",
"PLAYER_ID_RECEIVED_NM": "구자룡",
"PLAYER_RECEIVED_POSITION_CD": 2,
"PLAYER_RECEIVED_POSITION_NM": "DF",
"PASS_COUNT": 4
},
{
"MEET_YEAR": "2026",
"MEET_SEQ": 1,
"GAME_ID": "1",
"TEAM_ID": "K05",
"PLAYER_ID": "20060011",
"PLAYER_NM": "최철순",
"PLAYER_POSITION_CD": 2,
"PLAYER_POSITION_NM": "DF",
"PLAYER_ID_RECEIVED": "20210271",
"PLAYER_ID_RECEIVED_NM": "백승호",
"PLAYER_RECEIVED_POSITION_CD": 3,
"PLAYER_RECEIVED_POSITION_NM": "MF",
"PASS_COUNT": 10
}
],
"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/unOfficialMatchPassMatrixRecord.do?authKey=YOUR_API_KEY&meet_year=2026&meet_seq=1&team_id=K05&game_id=1";
Request request1 = new Request.Builder().url(url1).get().build();
// [방법 2] Header 방식 (현재 권장)
String url2 = "https://api.kleague.com/api/unOfficialMatchPassMatrixRecord.do?meet_year=2026&meet_seq=1&team_id=K05&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/unOfficialMatchPassMatrixRecord.do"
params = {
"meet_year": "2026",
"meet_seq": "1",
"team_id": "K05",
"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/unOfficialMatchPassMatrixRecord.do';
const params = { meet_year: '2026', meet_seq: '1', team_id: 'K05', 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' } });