/api/v1/servers/report

현재 라운드의 시드를 보고합니다. 차단 규칙은 플러그인 경로와 같습니다. 첫 보고 시점부터 직접 등록 키는 최대 1시간, 디스코드 HTTP 키는 최대 20분 차단됩니다. 직접 등록 키는 등록된 IP에서만, 디스코드 HTTP 키는 어디서든 보낼 수 있습니다.

Bearer 서버 키12 / min · credentialsince v1

요청 헤더

헤더	값	설명
Authorization	Bearer slsrv_…	직접 등록 또는 디스코드 HTTP 키로 받은 서버 키
Content-Type	application/json	UTF-8 JSON
User-Agent	MyServer/1.0	권장. 구현 이름과 버전.

요청 본문

필드	위치	타입	필수	설명
event	body	string	필수	round_start, round_end, periodic 중 하나.
seed	body	integer	필수	1..2147483647. round_end에는 해당 라운드의 시드를 보냅니다.
port	body	integer	필수	1..65535. 게임 서버 포트.
roundId	body	string	선택	1..64자.
roundStartedAt	body	string	선택	ISO-8601 UTC.
elapsedSeconds	body	number	선택	0 이상.

응답

상태	본문	언제
200	{"ok":true,"blockedUntil":"2026-09-15T08:05:00Z"}	보고 완료. blockedUntil은 이 시드의 차단 종료 시각이며, 차단되지 않았으면 null입니다.
400	{"error":"invalid request"}	형식 오류입니다.
401	{"error":"invalid credential"}	존재하지 않거나 폐기된 서버 키이거나, 등록된 IP가 아닌 곳에서 보낸 보고입니다. 보고를 중단하고 서버 키를 다시 발급받으세요.
429	{"error":"rate limited"}	서버 키당 분당 12회 또는 IP당 분당 120회를 초과했습니다.
503	{"error":"db unavailable"}	잠시 후 다시 요청하세요.

응답 필드

필드	타입	null	설명
ok	boolean	아님	항상 true 입니다.
blockedUntil	string	가능	이 시드의 차단이 끝나는 시각(ISO-8601 UTC). 차단 중이 아니면 null 입니다. 차단됐는지는 이 값으로 판단합니다.
exhausted	boolean	있을 때만	이 시드의 차단 예산이 다 찼을 때만 true 로 존재합니다. 차단되지 않았습니다.

예시

curl -X POST https://slmaps.com/api/v1/servers/report -H "Authorization: Bearer slsrv_..." -H "User-Agent: MyServer/1.0" -H "Content-Type: application/json" -d "{\"event\":\"round_start\",\"seed\":1848055747,\"port\":7777}"

요청 예시

{
  "event": "round_start",
  "seed": 1848055747,
  "port": 7777
}

응답 예시

{
  "ok": true,
  "blockedUntil": "2026-09-15T08:05:00Z"
}

플러그인 동작

round_start와 round_end는 반드시 보내야 합니다. round_end를 보내면 차단이 즉시 해제되어 종료된 라운드의 시드가 더 이상 차단되지 않습니다. 버전 필드는 없으며, 최소 버전 검사는 플러그인 경로에만 적용됩니다.

SLMAPS는 SCP: Secret Laboratory의 시드 지도 뷰어입니다. 이 문서는 slmaps.com의 공개 API를 설명합니다.slmaps.com ·