/api/plugin/v1/report

현재 라운드의 시드를 보고합니다. 첫 보고 시점부터 해당 시드는 SLMAPS에서 수집되거나 조회되지 않습니다. 차단은 최대 1시간입니다.

Bearer 서버 키12 / min · credentialsince 1.0.0

요청 헤더

헤더	값	설명
Authorization	Bearer slsrv_…	서버 등록으로 받은 서버 키
Content-Type	application/json	UTF-8 JSON

요청 본문

필드	위치	타입	필수	설명
event	body	string	필수	round_start, round_end, periodic 중 하나. round_start와 round_end는 항상 보냅니다.
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 이상.
pluginVersion	body	string	선택	1..32자. 최소 버전 검사에 사용됩니다.

응답

상태	본문	언제
200	{"ok":true,"blockedUntil":"2026-09-15T08:05:00Z"}	보고 완료. blockedUntil은 이 시드의 차단 종료 시각이며, 차단되지 않았으면 null입니다. 참고용 값입니다.
400	{"error":"invalid request"}	형식 오류입니다.
401	{"error":"invalid credential"}	존재하지 않거나 폐기된 서버 키이거나, 등록된 IP가 아닌 곳에서 보낸 보고입니다. 보고를 중단하고 서버를 다시 등록하세요.
426	{"error":"plugin_outdated","minimum":"1.2.0","downloadUrl":"https://…"}	pluginVersion이 최소 버전보다 낮습니다. downloadUrl로 업데이트를 안내하세요.
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/plugin/v1/report -H "Authorization: Bearer slsrv_..." -H "User-Agent: MyServer/1.0" -H "Content-Type: application/json" -d "{\"event\":\"round_start\",\"seed\":1848055747,\"port\":7777,\"pluginVersion\":\"1.2.2\"}"

요청 예시

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

응답 예시

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

플러그인 동작

round_start와 round_end는 항상 보냅니다. periodic은 기본 60초 간격이며 0이면 보내지 않습니다. 401이 반환되면 보고를 중단하고 운영자에게 재등록을 안내합니다. 429, 503, 네트워크 오류는 재시도 간격을 늘려 다시 요청합니다.

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