홈시작하기HTTP 키로 등록하기디스코드 없이 서버 등록하기디스코드로 서버 등록하기시드 보고와 차단버전 확인과 426인증과 서버 키차단 모델오류 처리요청 한도버전과 호환성POST /v1/servers/claimPOST /v1/servers/reportPOST /v1/servers/revokePOST /plugin/v1/claimPOST /plugin/v1/reportGET /plugin/v1/versionGET /maps/{seed}GET /jobs/{seed}GET /seedsGET /stats/overviewGET /stats/protectionAPI 변경 내역
조회 API
GET
/api/jobs/{seed}
시드의 맵 생성 상태를 조회합니다. /api/maps/{seed}가 202를 반환한 뒤 이 경로로 진행 상태를 확인합니다. 차단 규칙은 maps와 같습니다.
경로 / 쿼리
| 필드 | 위치 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| seed | path | integer | 필수 | 1..2147483647. |
응답
| 상태 | 본문 | 언제 |
|---|---|---|
| 200 | {"seed":1848055747,"status":"queued","ahead":2} | status는 queued, running, ready, error 중 하나입니다. ahead는 대기 중일 때만, error는 실패했을 때만 포함됩니다. ready가 되면 /api/maps/{seed}가 200을 반환합니다. |
| 400 | {"error":"invalid seed"} | 시드 형식이 올바르지 않습니다. |
| 403 | {"error":"blocked","blockedUntil":"2026-09-15T08:05:00Z"} | 서버 운영자가 차단 중인 시드입니다. blockedUntil 이후 다시 요청하세요. |
응답 필드
| 필드 | 타입 | null | 설명 |
|---|---|---|---|
| seed | integer | 아님 | 요청한 시드. |
| status | string | 아님 | queued, running, ready, error 중 하나. 아직 요청된 적 없는 시드는 queued 로 생성이 시작됩니다. |
| ahead | integer | 있을 때만 | queued 일 때만 있습니다. 앞에 대기 중인 시드 수. |
| error | string | 있을 때만 | error 일 때만 있습니다. 실패 이유. |
예시
curl https://slmaps.com/api/jobs/1848055747 -H "User-Agent: MyServer/1.0"
응답 예시
{
"seed": 1848055747,
"status": "queued",
"ahead": 2
}뷰어 동작
뷰어는 maps와 jobs의 403을 같은 방식으로 처리합니다. blockedUntil이 없는 403은 영구 차단으로 간주하고 재시도하지 않습니다.
SLMAPS는 SCP: Secret Laboratory의 시드 지도 뷰어입니다. 이 문서는 slmaps.com의 공개 API를 설명합니다.slmaps.com ·