14.2.7
조회 API
GET

/api/maps/{seed}

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

인증 없음20 / min · IP (uncached)since v1
경로 / 쿼리
필드위치타입필수설명
seedpathinteger필수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설명
seedinteger아님요청한 시드.
roomsarray아님방 배치. 항목은 아래 rooms 표를 보세요.
markersarray아님공개 응답에서는 항상 빈 배열입니다.
spawnsarray아님시드로 정해지는 후보 스폰 위치. 항목은 아래 spawns 표를 보세요.
doorsarray아님헤비 도어 위치. 옛 덤프에서는 빈 배열입니다.
teslasarray아님테슬라 게이트 위치. 옛 덤프에서는 빈 배열입니다.
transitionsobject있을 때만구역 사이 이동 연결 정보. 값이 있을 때만 포함됩니다.
transitionCoverageobject있을 때만구역 이동 연결 정보를 어디까지 기록했는지. 값이 있을 때만 포함됩니다.
rooms의 항목
필드타입null설명
namestring아님방 이름(게임의 RoomName). 예: HczArmory, LczClassDSpawn.
zonestring아님LightContainment, HeavyContainment, Entrance, Surface, Other 중 하나.
shapestring아님Straight, Curve, TShape, XShape, Endroom, Undefined 중 하나.
x, y, znumber아님방 중심의 월드 좌표. y는 층을 뜻합니다(저위험군 100, 고위험군·출입구역 -100).
rotYnumber아님Y 축 회전(도). 0, 90, 180, 270 중 하나입니다.
variantstring가능게임 프리팹 인스턴스 이름. 옛 덤프에서는 null입니다.
connarray아님이어진 방들의 중심 좌표 [{x, z}]. 층이 다르면 y와 zone이 더 붙습니다.
spawns의 항목
필드타입null설명
kindstring아님structure(구조물) 또는 item(아이템).
catstring아님structure는 놓일 수 있는 구조물 종류를 |로 이은 값(예: StandardLocker|SmallWallCabinet). item은 item:<ItemType> 또는 item:group.
x, y, znumber아님스폰 위치의 월드 좌표.
rx, rznumber아님이 스폰이 속한 방의 중심 좌표. rooms의 x, z와 맞춰 방을 찾습니다.
doors의 항목
필드타입null설명
namestring아님문 이름.
zonestring아님rooms의 zone과 같은 값.
x, y, znumber아님월드 좌표.
rotYnumber아님Y 축 회전(도).
checkpointboolean아님구역 사이 검문소 문이면 true.
teslas의 항목
필드타입null설명
x, y, znumber아님월드 좌표.
rx, rznumber아님속한 방의 중심 좌표.
예시
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 ·