콘텐츠로 이동

변경 이력

이 페이지는 공개 Chizumulu API와 개발자 문서에서 개발자가 체감할 수 있는 변경 사항을 기록합니다. API 동작에 영향을 주지 않는 내부 구현 변경은 싣지 않습니다. 각 항목마다 개발자가 따로 할 일이 있는지도 함께 적어 둡니다.

  • 한 실제 경기(Vision S Academy vs Chintheche United)가 서로 다른 두 경기로 노출되던 문제를 고쳤어요. 아직 멀티버스는 증명되지 않았으니, 이러는 편이 더 적절할 겁니다. 한 관찰 기록에서 팀 이름이 registry에 등록되지 않은 표기(대소문자 오타)로 들어오면서, 경기가 오래된 스코어에 멈춘 별개의 경기로 갈라져 있었습니다. 팀 registry를 보정하자 다음 업데이트 때 두 기록은 자동으로 재투영되어 하나의 경기로 병합되었습니다. 개발자 여러분은 다행히도 따로 대응할 필요는 없습니다. 응답 형식도 바뀌지 않았습니다. 팀 식별자를 참고하세요.
  • GET /v1/matches: 상태, competitionCode, teamId, teamAlias, updatedSince로 파생 경기를 검색하고 커서로 넘겨볼 수 있습니다. /v1/structured를 뒤져 직접 경기 퍼즐을 맞추던 작업을 이제 API가 대신합니다. /v1/live와 달리 오래되었거나 과거의 경기까지, 프로젝션이 알고 있는 모든 경기를 돌려줍니다. 새 경로이므로 옮길 것은 없습니다. GET /v1/matches를 참고하세요.
  • GET /v1/teams, GET /v1/teams/{teamId}: 표준 팀 registry(id, 표시 이름, 별칭)를 JSON으로 제공합니다. 이제 팀 별칭을 직접 하드코딩하지 않아도 됩니다. 지금까지 표준화한 팀만 담고 있으며, NRFA 클럽 전체는 아닙니다. 옮길 것은 없습니다. GET /v1/teams를 참고하세요.
  • 정규화된 숫자 minute("90+4'"는 94, 해석할 수 없으면 null)이 이제 문자 그대로인 minuteText 옆에 함께 옵니다. /v1/structured의 경기·이벤트 객체와 파생 경기 엔드포인트(/v1/live, /v1/matches, /v1/matches/{matchId}) 모두에 적용됩니다. 시간은 원래 흐르고 있었지만, 이제 API도 그걸 숫자로 알려줍니다. 추가된 것 자체는 따로 대응할 필요가 없습니다. 아래 변경 항목의 이름 변경을 함께 확인해 주세요.
  • 파생 경기 엔드포인트에서만, 분을 문자 그대로 담던 필드 이름이 minute에서 minuteText로 바뀌었고, 그 자리는 새 숫자 minute이 대신합니다. 며칠 전에 나온 /v1/live와 /v1/matches/{matchId}에만 해당하며, /v1/structured의 minuteText는 영향받지 않았습니다. 이전 필드를 쓰던 연동은 확인되지 않아 클라이언트가 따로 대응할 필요는 없습니다. 다만 그 두 경로에서 예전 텍스트 필드를 이미 파싱하고 있었다면, 새 이름으로 바꿔 주세요.
  • 팀 이름 하나 고쳤다고 오래된 파생 경기까지 손으로 청소할 필요는 이제 없습니다. 팀 registry가 바뀌면, 관계없는 새 관찰을 기다리지 않고 영향받은 경기를 자동으로 재투영합니다. 덕분에 인식되지 않은 팀 이름 표기나 대소문자 차이(Chipolopolo, Ekwendeni Fc, Lube Masters Fc, Vision Academy) 때문에 한 경기가 두 번 노출되던 알려진 사례 여러 건이 해결되었습니다. 클라이언트 쪽 변경은 필요 없습니다.
  • 문서만으로 부족할 때 이제 찾아갈 곳이 생겼습니다. 카테고리별 자가 해결 답변과 개발자 지원팀으로 이어지는 경로를 갖춘 이중언어 도움 받기 페이지입니다.
  • GET /v1/live, GET /v1/matches/{matchId}: 구조화된 관찰을 바탕으로 한 파생 경기 프로젝션입니다. “지금 진행 중인 경기가 뭐지?“를 원본 게시물에서 직접 추리하지 않아도 됩니다. 실시간 보기는 일부러 보수적이라, 소식이 끊긴 경기는 다음 업데이트가 올 때까지 목록에서 빠지지만 저장은 그대로 유지되고 id로 조회할 수 있습니다. 두 번째 경로는 한 경기의 전체 업데이트 이력을 보여 줍니다. 새 경로이므로 옮길 것은 없습니다. 파생 경기를 참고하세요.
  • /v1/structured 항목과 이력 관찰에 attachmentFacts가 추가되었습니다. 구조화 결과가 없는 게시물에서도 이미지로 읽은 사실(현재는 리그 순위표)이 더 이상 사라지지 않고 여기에 나타납니다. 이미 구조화 결과가 있던 응답은 그대로여서 따로 대응할 필요가 없습니다.
  • 최초의 공개 문서, OpenAPI 스키마, llms.txt: 이제 API에도 지도가 생겼습니다. 출시 시점에 공개 문서화된 엔드포인트는 GET /v1/structured(및 /{rawUpdateId}/history), GET /v1/updates, GET /v1/latest, GET /v1/feed, GET /v1/status입니다. 따로 할 일은 없습니다. 여기가 출발선입니다.
  • GET /v1/structured 필터: competition, team, postType, teamId(표준 팀 식별자), teamAlias(대소문자만 구분하지 않는 축약형). 표기를 일일이 맞춰 보지 않아도 한 클럽만 골라 볼 수 있습니다. 팀 식별자, 팀 별칭을 참고하세요.
  • GET /v1/videos, GET /v1/videos/latest: 공개 유튜브 채널 피드 하나를 캐시해 그대로 전달하는 작은 엔드포인트입니다. 앱에 영상도 넣고 싶을 때 쓰세요.
  • 보관된 이미지에서 한 종류의 구조화 데이터, 즉 리그 순위표를 읽어 standings 팩트로 노출합니다. 표는 저희가 읽을 테니 눈을 찡그리지 않으셔도 됩니다.
  • 공개 GET 경로에 CORS가 열렸습니다(Access-Control-Allow-Origin: *). 브라우저 기반 클라이언트가 API를 직접 호출할 수 있습니다. 따로 대응할 필요는 없습니다.
  • API와 processor는 이제 커스텀 도메인에서만 서비스되며, 플랫폼 기본 미리보기 주소는 제공되지 않습니다. 다른 호스트 이름으로 호출하고 있었다면 문서에 나온 기본 URL로 바꿔 주세요.