/api/maps/{seed}

시드의 맵을 조회합니다. 아직 생성되지 않은 시드는 202를 반환하고 생성을 시작합니다. 서버 운영자가 차단 중인 시드는 403과 함께 blockedUntil을 반환합니다.

인증 없음20 / min · IP (uncached)since v1

경로 / 쿼리

필드	위치	타입	필수	설명
seed	path	integer	필수	1..2147483647.

응답

상태	본문	언제
200	{"seed":1848055747,"rooms":["…"],"markers":[],"spawns":["…"],"doors":["…"],"teslas":["…"]}	맵 JSON입니다. rooms는 방 배치, spawns는 후보 스폰 위치, doors와 teslas는 장치 위치입니다. markers(실제 배치)는 공개 응답에서 비어 있습니다. transitions와 transitionCoverage는 값이 있을 때만 포함됩니다.
202	{"status":"pending","job":"queued"}	아직 생성되지 않은 시드입니다. 생성이 시작됐으므로 /api/jobs/{seed}로 상태를 확인하거나 잠시 후 다시 요청하세요. 생성은 보통 몇 초에서 1분 정도 걸립니다.
400	{"error":"invalid seed"}	시드 형식이 올바르지 않습니다.
403	{"error":"blocked","blockedUntil":"2026-09-15T08:05:00Z"}	서버 운영자가 차단 중인 시드입니다. blockedUntil 이후 다시 요청하세요. 영구 차단(블랙리스트)의 403에는 blockedUntil이 없습니다.
429	{"error":"rate limited"}	아직 생성되지 않은 시드를 IP당 분당 20개 넘게 요청했습니다. 이미 생성된 시드에는 한도가 없습니다.
503	{"status":"busy","error":"map unavailable"}	생성 대기열이 가득 찼거나 생성에 실패했습니다. 잠시 후 다시 요청하세요.

응답 필드

필드	타입	null	설명
seed	integer	아님	요청한 시드.
rooms	array	아님	방 배치. 항목은 아래 rooms 표를 보세요.
markers	array	아님	공개 응답에서는 항상 빈 배열입니다.
spawns	array	아님	결정적인 후보 스폰 위치. 항목은 아래 spawns 표를 보세요.
doors	array	아님	중량문 위치. 옛 덤프에서는 빈 배열입니다.
teslas	array	아님	테슬라 게이트 위치. 옛 덤프에서는 빈 배열입니다.
transitions	object	있을 때만	방 사이 전환 정보. 값이 있을 때만 포함됩니다.
transitionCoverage	object	있을 때만	전환 정보의 범위. 값이 있을 때만 포함됩니다.

rooms의 항목

필드	타입	null	설명
name	string	아님	방 이름(게임의 RoomName). 예: HczArmory, LczClassDSpawn.
zone	string	아님	LightContainment, HeavyContainment, Entrance, Surface, Other 중 하나.
shape	string	아님	Straight, Curve, TShape, XShape, Endroom, Undefined 중 하나.
x, y, z	number	아님	방 중심의 월드 좌표. y 는 층을 뜻합니다(경량 100, 중량·입구 -100).
rotY	number	아님	Y 축 회전(도). 0, 90, 180, 270 중 하나입니다.
variant	string	가능	게임 프리팹 인스턴스 이름. 옛 덤프에서는 null 입니다.
conn	array	아님	이어진 방들의 중심 좌표 [{x, z}]. 층이 다르면 y 와 zone 이 더 붙습니다.

spawns의 항목

필드	타입	null	설명
kind	string	아님	structure(구조물) 또는 item(아이템).
cat	string	아님	structure 는 놓일 수 있는 구조물 종류를 \| 로 이은 값(예: StandardLocker\|SmallWallCabinet). item 은 item:<ItemType> 또는 item:group.
x, y, z	number	아님	스폰 위치의 월드 좌표.
rx, rz	number	아님	이 스폰이 속한 방의 중심 좌표. rooms 의 x, z 와 맞춰 방을 찾습니다.

doors의 항목

teslas의 항목

필드	타입	null	설명
x, y, z	number	아님	월드 좌표.
rx, rz	number	아님	속한 방의 중심 좌표.

예시

curl https://slmaps.com/api/maps/1848055747 -H "User-Agent: MyServer/1.0"

응답 예시

{
  "seed": 1848055747,
  "rooms": [
    "…"
  ],
  "markers": [],
  "spawns": [
    "…"
  ],
  "doors": [
    "…"
  ],
  "teslas": [
    "…"
  ]
}

뷰어 동작

slmaps.com 뷰어는 202를 받으면 /api/jobs/{seed}를 폴링하고, 403을 받으면 blockedUntil까지 남은 시간을 표시한 뒤 자동으로 다시 조회합니다. 차단은 첫 보고 시점부터 최대 1시간(HTTP 키는 20분)입니다.

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