순찰 관리 웹 (더미)

현장: -

-

로그



연동 가이드 — 순찰 관리 웹 로그인 (단지관리자)

단지관리자는 순찰 웹에서 아이디·비밀번호를 입력하지 않습니다. townconsole 에서 순찰 관리를 누르면 아래 주소로 새 탭이 열립니다.
{순찰 웹}/sites/{현장 uuid}#tt={임시토큰} (임시토큰: 5분, 1회용)

처리 순서

  1. 경로에서 현장 uuid, # 뒤에서 tt 를 읽는다
  2. 바로 주소에서 # 을 지운다 (history.replaceState)
  3. POST /user/signin-with-token { token } → accessToken, refreshToken, expiresIn
  4. GET /sites/{uuid} (Bearer accessToken) → 현장 이름·상태
  5. 만료 전 POST /user/token { refreshToken } 으로 갱신

새로고침 시 #tt 가 없으므로 저장해 둔 토큰으로 진행합니다. 저장된 토큰도 없으면 "townconsole 에서 순찰 관리로 들어와 주세요" 로 안내합니다.

API (dev 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 }

codeHTTP언제
E0002400토큰 형식 오류
E0005401임시토큰 만료·재사용, refreshToken 만료 → townconsole 에서 다시 진입 안내
E0006403단지관리자 계정이 아님

지켜야 할 것