API 변경 내역

차단 API v1의 변경 사항을 최신순으로 정리합니다.

1. 2026-09-17

   추가
   • POST /api/v1/servers/revoke 추가. 서버 키를 가진 쪽이 그 키를 폐기합니다. 노출된 HTTP 키를 디스코드 없이 끝낼 수 있습니다.
   • 모든 429 응답에 Retry-After 헤더(초)가 붙습니다.
   • 문서의 예시에 User-Agent 헤더를 넣었습니다. 일부 라이브러리 기본값은 CDN이 막습니다.
2. 2026-09-17

   변경
   • 차단 길이가 바뀌었습니다. 게임 서버에서 직접 보내는 등록(플러그인·직접 등록)은 최대 1시간, 디스코드 HTTP 키는 최대 20분입니다.
   • 시드마다 누적 예산이 생겼습니다. 서버 직접 1시간, HTTP 키 20분을 다 쓴 시드는 다시 차단되지 않습니다.
   • report 응답에 exhausted: true 가 추가됩니다(예산이 다 찬 시드).
3. 2026-09-17

   추가
   • 디스코드에서 신청해 받는 HTTP 키 추가. 플러그인 없이 /api/v1/servers/report만으로 시드를 보고할 수 있습니다. 이 키는 IP에 묶이지 않습니다.
4. 2026-09-16

   추가
   • 서버 API /api/v1/servers/claim, report 추가. 디스코드 없이 게임 서버에서 바로 서버 키를 받습니다.
   • 직접 등록은 요청을 보낸 IP에 SCP:SL 서버가 실행 중인지 A2S_INFO로 확인합니다.
   • 직접 등록 한도: IP당 5분에 하나, 사용 중인 서버 키는 IP당 최대 3개. 같은 IP:포트의 사용 중인 등록을 교체하려면 기존 서버 키가 필요합니다(409).
   • /api/plugin/v1/*는 그대로 유지됩니다. 이미 배포된 플러그인이 계속 사용합니다.
5. 2026-09-16

   변경
   • round_end가 차단 방식과 관계없이 차단을 즉시 해제합니다. 이전에는 연장 방식에서만 해제됐습니다.
   • 재차단 대기 시간이 30초에서 5분으로 늘었습니다.
   • 서버당 차단은 한 번에 하나입니다. 차단 중인 시드가 있으면 다른 시드를 보고해도 차단되지 않습니다.
   • 서버 키당 보고 한도가 분당 30회에서 12회로 줄었습니다.
   • claim이 요청을 보낸 주소로 자동 등록됩니다. 수동 확인은 이전 방식의 요청에만 남습니다.
6. plugin 1.2.0

   추가
   • GET /api/plugin/v1/version 추가.
   • 최소 버전 미만 요청은 426 plugin_outdated로 거절됩니다. 1.0.0과 1.1.0은 이를 알 수 없는 실패로 처리하고 재시도합니다.
7. plugin 1.1.0

   추가
   • POST /api/plugin/v1/claim 추가. 디스코드 봇이 발급한 코드로 서버를 등록합니다.
8. plugin 1.0.0

   최초
   • POST /api/plugin/v1/report. 응답에 blockedUntil이 포함됩니다.