ClawOps APIMobile Gateways

모바일 게이트웨이 enroll 토큰 발급

View as Markdown

BT 휴대폰 게이트웨이(chan_mobile 박스)를 이 계정에 등록하기 위한 1회용 enroll 토큰을 발급한다. 반환된 평문 토큰을 박스 control-agent 에 붙여넣으면 박스가 WireGuard 키를 로컬 생성해 콜홈 (POST /v1/mobile-gateways/enroll)한다. 토큰은 24시간·단일사용, DB 엔 sha256 해시만 저장.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

Request

This endpoint expects an object.
didNumberstringOptional

이 게이트웨이가 쓸 발신 DID(선택). 미지정 시 enroll 후 콘솔에서 배정.

Response

발급 성공 — 평문 토큰(1회 노출)

tokenstring

1회용 enroll 토큰(평문). 이 응답에만 노출된다(DB 엔 sha256 해시만 저장). 박스 control-agent :8088 UI 에 붙여넣어 콜홈 enroll 에 사용. 24시간 후 만료·단일사용.

expiresAtdatetime

토큰 만료 시각(ISO 8601). 발급 후 24시간.

Errors

401
Unauthorized Error