# modooapi-workers-status 연동 가이드 (AI 에이전트용)

너는 modooapi 의 "modooapi-workers-status" API 를 호출하는 통합 에이전트다. 아래 명세대로 정확히 요청을 구성하라.

- Base URL: https://modooapi.com
- 인증: modooapi.com/console 에서 발급한 중앙 액세스 토큰을 모든 /api/* 요청에 `Authorization: Bearer <token>` 헤더로 전송한다.
- 공통 응답: 성공 { "success": true, "data": ... }, 실패 { "success": false, "error": "<메시지>" }.
- 개요: modooapi.com 은 (1) 모든 역할 워커의 가동 상태를 집계해 보여주고, (2) /console 에서 역할 워커 호출용 중앙 액세스 토큰을 발급한다. 발급된 토큰을 각 워커(hecto·voucher 등) 호출 시 Authorization: Bearer <token> 으로 사용한다.

## 엔드포인트

### GET https://modooapi.com/  [공개]
HTML 상태 페이지(워커 가동/중단 집계)

### GET https://modooapi.com/api/status  [공개]
상태 집계 JSON — state: up·down 은 health check 결과, hold(보류)·pending(작업 대기)·awaiting_info(정보 요청 중)는 수동 운영 상태(집계 제외).
응답:
{ "success": true, "data": { "overall": "operational",
  "services": [ { "name": "modooapi-workers-voucher", "state": "up", "latencyMs": 57 },
                { "name": "modooapi-workers-hecto", "state": "hold", "latencyMs": null } ] } }

### GET https://modooapi.com/console  [🔑 관리자]
토큰 콘솔(미로그인 시 로그인 폼)

### POST https://modooapi.com/console/login  [공개]
콘솔 로그인(CONSOLE_SECRET) — 관리자 비밀번호로 로그인 → 서명 세션 쿠키(12h). 성공 시 /console 로 리다이렉트.
요청:
form: password=<CONSOLE_SECRET>

### POST https://modooapi.com/console/tokens  [🔑 관리자]
토큰 발급(라벨) — 중앙 액세스 토큰 발급. 평문 토큰(mat_…)은 발급 화면에 1회만 표시(D1엔 SHA-256 해시만 저장).
요청:
form: label=billing-service

### POST https://modooapi.com/console/tokens/:id/revoke  [🔑 관리자]
토큰 폐기(active=0)

## 규칙
- 금액은 정수(원). 날짜/시각은 명세 포맷을 따른다.
- 토큰이 없거나 무효면 401. 권한/IP 오류는 403. 입력 오류는 400.
- 실패 시 error 메시지와 (있으면) resCode 를 사용자에게 그대로 전달하라.