시작하기 · SLMAPS API 문서

시작하기

차단 API는 서버 키를 받고 라운드마다 시드를 보고하는 두 단계입니다. 조회 API는 키 없이 바로 부를 수 있습니다.

경로 고르기

직접 등록권장

게임 서버 머신에서 요청 한 번으로 키를 받습니다. 플러그인도 디스코드도 필요 없습니다. 직접 구현할 때 권장하는 경로입니다.

가이드 →

디스코드 HTTP 키

게임 서버에 접근할 수 없을 때 디스코드에서 키를 받습니다. IP에 묶이지 않고 차단 상한은 20분입니다.

가이드 →

공식 플러그인

플러그인을 설치하면 등록과 보고가 자동입니다. 디스코드에서 코드를 받아 서버 콘솔에 입력합니다.

가이드 →

공통 규칙

Base URL	https://slmaps.com/api	HTTPS만 받습니다. http:// 요청은 301로 https:// 에 보내지므로 처음부터 https를 쓰세요.
본문	application/json; charset=utf-8	요청과 응답 모두 JSON입니다. 숫자 필드에 문자열을 넣으면 400입니다.
User-Agent	MyServer/1.0	구현 이름과 버전을 넣으세요. 라이브러리 기본값 일부(Python-urllib 등)는 CDN이 403으로 막습니다.
인증	Authorization: Bearer slsrv_…	차단 API의 report에만 필요합니다. 조회 API는 인증이 없습니다.
시각	2026-09-17T09:00:00Z	ISO-8601 UTC 문자열입니다. 소수점 초가 붙을 수 있습니다.
요청 IP	CF-Connecting-IP	CDN이 붙입니다. 클라이언트가 IP를 보내는 필드는 없습니다.

5분 안에 해 보기

직접 등록 경로로 키를 받고, 시드를 보고하고, 차단을 확인한 뒤 해제합니다. 1번은 게임 서버가 실행 중인 머신에서 보내야 합니다.

# 1. 게임 서버 머신에서 서버 키 발급
curl -X POST https://slmaps.com/api/v1/servers/claim -H "Content-Type: application/json" -H "User-Agent: MyServer/1.0" -d "{\"port\":7777,\"clientName\":\"my-server\"}"
# -> {"status":"verified","serverId":"...","credential":"slsrv_...","issuedAt":"..."}

# 2. 라운드 시작: 시드 보고
curl -X POST https://slmaps.com/api/v1/servers/report -H "Authorization: Bearer slsrv_..." -H "Content-Type: application/json" -H "User-Agent: MyServer/1.0" -d "{\"event\":\"round_start\",\"seed\":1848055747,\"port\":7777}"
# -> {"ok":true,"blockedUntil":"2026-09-17T09:00:00Z"}

# 3. 확인: 차단 중이면 403
curl https://slmaps.com/api/maps/1848055747 -H "User-Agent: MyServer/1.0"
# -> 403 {"error":"blocked","blockedUntil":"2026-09-17T09:00:00Z"}

# 4. 라운드 종료: 차단 해제
curl -X POST https://slmaps.com/api/v1/servers/report -H "Authorization: Bearer slsrv_..." -H "Content-Type: application/json" -H "User-Agent: MyServer/1.0" -d "{\"event\":\"round_end\",\"seed\":1848055747,\"port\":7777}"
# -> {"ok":true,"blockedUntil":null}

다음에 읽을 것

인증과 서버 키세 경로의 차이와 키 관리 차단 모델차단 길이, 상한, 예산, 쿨다운 오류 처리모든 오류 문자열과 재시도 규칙 요청 한도한도표와 세는 방식 버전과 호환성추가만 하는 v1 약속

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