현장: -
-
단지관리자는 순찰 웹에서 아이디·비밀번호를 입력하지 않습니다. townconsole 에서 순찰 관리를 누르면 아래 주소로 새 탭이 열립니다.
{순찰 웹}/sites/{현장 uuid}#tt={임시토큰} (임시토큰: 5분, 1회용)
# 뒤에서 tt 를 읽는다# 을 지운다 (history.replaceState)POST /user/signin-with-token { token } → accessToken, refreshToken, expiresInGET /sites/{uuid} (Bearer accessToken) → 현장 이름·상태POST /user/token { refreshToken } 으로 갱신새로고침 시 #tt 가 없으므로 저장해 둔 토큰으로 진행합니다. 저장된 토큰도 없으면 "townconsole 에서 순찰 관리로 들어와 주세요" 로 안내합니다.
https://api-dev.kysco.kr/api/v1/patrol)| API | 요청 | 응답 |
|---|---|---|
| POST /user/signin-with-token | { token } (인증 없음) | { accessToken, refreshToken, expiresIn } |
| POST /user/token | { refreshToken } | 같음 |
| GET /sites/{uuid} | Bearer accessToken | { name, operationStatus, … } |
{ error, message, code, status }| code | HTTP | 언제 |
|---|---|---|
| E0002 | 400 | 토큰 형식 오류 |
| E0005 | 401 | 임시토큰 만료·재사용, refreshToken 만료 → townconsole 에서 다시 진입 안내 |
| E0006 | 403 | 단지관리자 계정이 아님 |
?tt=(쿼리)가 아니라 #tt= 로 받는다. # 뒤 값은 서버로 가지 않아 서버·CDN 로그, Referer 에 남지 않는다