Refresh/Cron API

보호된 쓰기성 API
Home Try menu Try schedule
전체 문서 섹션 검색을 지원합니다.

보호 API 목록

쓰기/갱신 API는 모두 인증이 필요합니다.

  • GET /api/refresh
  • GET /api/bootstrap
  • GET /api/schedule-cron
  • GET|POST /api/schedule?refresh=true

Authorization: Bearer <CRON_SECRET> 헤더가 필수입니다.

갱신 규칙

학식은 월 단위 갱신, 15일 이후에는 다음달 preload를 같이 시도합니다.

  • 현재 월 갱신 실패 시 기존 캐시를 유지합니다.
  • 매월 15일 이후(로컬 KST)에는 다음달 데이터를 하루 1회 best-effort로 미리 조회합니다.
  • 결과는 응답의 nextMonthPreload에 기록됩니다.

Discord 알림

웹훅은 환경변수로만 설정합니다.

DISCORD_WEBHOOK_URL이 설정된 경우에만 refresh 결과를 전송합니다.

코드에 웹훅 URL 하드코딩은 지원하지 않습니다.