누가 사용할 수 있나요?
골드 플랜을 사용하며 API를 켠 리그입니다. API를 켜려면 관리자 홈 > API > API 설정로 이동하여 JSON API 사용를 선택하세요. 둘 중 하나라도 빠져 있으면 이 문서들에 나오는 모든 웹 주소가 데이터 대신 오류를 반환합니다.
API란 무엇인가요?
API를 사용하면 다른 웹사이트, 앱 또는 프로그램이 LeagueRepublic에서 리그의 경기 일정, 결과, 순위표를 바로 읽어 올 수 있습니다. 웨이터라고 생각하면 됩니다. 웹사이트가 무언가를 요청하면("오늘 경기 부탁해요") LeagueRepublic이 답을 가져다줍니다.
어떻게 요청하나요?
웹 페이지를 여는 것과 똑같이 웹 주소를 방문합니다. 보기 좋게 꾸며진 페이지 대신 JSON이라는 형식의 일반 텍스트를 받게 됩니다. 웹 개발자의 코드나 AI 어시스턴트가 만든 페이지가 이 텍스트를 읽어 원하는 디자인으로 바꿔 줍니다.
JSON은 어떻게 생겼나요?
레이블과 값의 목록으로, 작성을 마친 양식과 비슷합니다.
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
콜론 앞의 단어는 필드 이름(양식의 레이블)입니다. 그 뒤의 부분은 값(칸에 적힌 내용)입니다. 각 필드 이름의 의미는 API 사양에 설명되어 있습니다.
ID란 무엇인가요?
LeagueRepublic의 모든 리그, 시즌, 디비전, 팀, 경기에는 ID라는 고유 번호가 있습니다. 회원 번호처럼 절대 바뀌지 않으며, 두 대상이 같은 번호를 갖는 일도 없습니다. 웹 주소에 ID를 넣어 원하는 시즌이나 팀을 지정합니다.
내 ID는 어떻게 찾나요?
리그 ID는 관리자 홈 > API > API 설정에 표시됩니다.
시즌 ID: [내-리그-ID] 자리에 리그 ID를 넣어 이 주소를 브라우저에서 여세요. 각 시즌이 ID와 함께 나열됩니다.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[내-리그-ID].json
디비전 및 팀 ID는 API가 보내 주는 목록에 나옵니다. …만들기 문서 중 하나를 사용하면 AI 어시스턴트가 대신 찾아 줍니다.
제한이 있나요?
네. 각 리그는 1분에 보낼 수 있는 요청 수가 정해져 있으며, 웹사이트, 앱 등 리그 데이터를 사용하는 모든 것이 이 한도를 함께 씁니다. 잘 만든 페이지는 같은 요청을 반복하지 않고 불러온 데이터를 저장해 둡니다. 정확한 한도는 API 사양에 나와 있습니다.
자주 보게 될 용어
Road – 원정 팀. 대부분의 사람들이 "away"라고 하는 것을 LeagueRepublic에서는 "road"라고 합니다.
경기(fixture) – 이미 치렀는지와 관계없이 하나의 경기.
경기 그룹(fixture group) – 디비전(예: "Premier Division"), 컵 대회 또는 기타 경기 묶음.
결과 – 점수가 있는 경기.
null – 칸이 비어 있습니다. 리그가 입력하지 않았거나 해당 사항이 없습니다.
true / false – 예 / 아니요.
자세한 내용은 어디에 있나요?
모든 필드 이름, 한도, 오류 메시지 등 정확한 내용은 모두 API 사양에 있습니다.