홈시작하기HTTP 키로 등록하기디스코드 없이 서버 등록하기디스코드로 서버 등록하기시드 보고와 차단버전 확인과 426인증과 서버 키차단 모델오류 처리요청 한도버전과 호환성POST /v1/servers/claimPOST /v1/servers/reportPOST /v1/servers/revokePOST /plugin/v1/claimPOST /plugin/v1/reportGET /plugin/v1/versionGET /maps/{seed}GET /jobs/{seed}GET /seedsGET /stats/overviewGET /stats/protectionAPI 변경 내역
개념
요청 한도
한도는 요청 IP 또는 서버 키 단위로 셉니다. 초과하면 429 {"error":"rate limited"} 입니다. 정상적인 서버 하나의 요청량은 한도의 10분의 1 아래입니다.
한도표
| 엔드포인트 | 한도 | 기준 | 비고 |
|---|---|---|---|
| POST /api/v1/servers/claim | 1 / 5분 | IP | 발급된 경우에만 소모. 서버 확인은 10 / 분, 사용 중인 키는 IP당 3개 |
| POST /api/v1/servers/report | 12 / 분 | 서버 키 | IP당 120 / 분이 별도로 적용 |
| POST /api/v1/servers/revoke | 20 / 분 | IP | |
| POST /api/plugin/v1/claim | 10 / 분 | IP | |
| POST /api/plugin/v1/report | 12 / 분 | 서버 키 | IP당 120 / 분이 별도로 적용 |
| GET /api/plugin/v1/version | 없음 | 5분 캐시 | |
| GET /api/maps/{seed} | 20 / 분 | IP | 아직 생성되지 않은 시드만. 생성된 시드는 한도 없음 |
| GET /api/jobs/{seed} | 없음 | ||
| GET /api/seeds | 없음 | ||
| GET /api/stats/* | 20 / 분 | IP | 60초 캐시. 캐시에서 응답할 때는 세지 않음 |
세는 방식
- 고정 구간으로 셉니다. 구간은 그 키의 첫 요청에 시작해 한도 시간 뒤에 끝나고, 다음 요청이 새 구간을 시작합니다.
- 한도를 넘은 요청도 구간 안의 횟수에 더해집니다. 429를 받은 뒤 바로 다시 보내면 구간이 끝날 때까지 계속 429입니다.
- 카운터는 메모리에 있어 서버가 재시작되면 초기화됩니다. 직접 등록의 5분 간격만 데이터베이스로도 확인합니다.
- 429 응답에는 Retry-After 헤더(초)가 있습니다. 직접 등록 간격의 429는 남은 시간을 정확히 모를 때 간격 전체(300초)를 적습니다.
직접 등록의 5분 간격
간격은 키가 발급된 경우에만 소모됩니다. 400, 403, 409, 503 응답과 서버 확인 실패는 간격을 되돌립니다. 포트를 잘못 적었다면 고쳐서 바로 다시 보내면 됩니다. 다만 서버 확인 자체는 IP당 분당 10회이고, 사용 중인 키 3개는 어떤 경우에도 회수되지 않습니다.
정상적인 요청량
서버 하나는 라운드마다 round_start 1회와 round_end 1회를 보냅니다. periodic을 60초 간격으로 보내면 분당 1회입니다. 서버 키당 한도 12회는 이보다 열 배 넉넉합니다. 10초보다 짧은 periodic 간격은 한도에 닿을 수 있으니 쓰지 마세요.
SLMAPS는 SCP: Secret Laboratory의 시드 지도 뷰어입니다. 이 문서는 slmaps.com의 공개 API를 설명합니다.slmaps.com ·