modooapi-workers-status

modooapi.com AI 프롬프트

modooapi 서비스 운영 상태(가동/중단) + 중앙 액세스 토큰 발급 콘솔. modooapi.com 은 (1) 모든 역할 워커의 가동 상태를 집계해 보여주고, (2) /console 에서 역할 워커 호출용 중앙 액세스 토큰을 발급한다. 발급된 토큰을 각 워커(hecto·voucher 등) 호출 시 Authorization: Bearer <token> 으로 사용한다.

인증
🔒 토큰 modooapi.com/console 발급 토큰을 Authorization: Bearer <token>
🔑 관리자콘솔 로그인 🛡 IP제한등록 발신 IP 공개인증 없음

엔드포인트

GET/helpGET/help/promptGET/healthGET/GET/api/statusGET/consolePOST/console/loginPOST/console/tokensPOST/console/tokens/:id/revoke
GET /help 공개
이 워커의 설명·연동 메뉴얼(HTML/JSON)
GET /help/prompt 공개
AI 에이전트 연동 프롬프트(text/plain)
GET /health 공개
가동 상태(status 워커가 집계)
GET / 공개
HTML 상태 페이지(워커 가동/중단 집계)
GET /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 /console 🔑 관리자
토큰 콘솔(미로그인 시 로그인 폼)
POST /console/login 공개
콘솔 로그인(CONSOLE_SECRET)
관리자 비밀번호로 로그인 → 서명 세션 쿠키(12h). 성공 시 /console 로 리다이렉트.
요청
form: password=<CONSOLE_SECRET>
POST /console/tokens 🔑 관리자
토큰 발급(라벨)
중앙 액세스 토큰 발급. 평문 토큰(mat_…)은 발급 화면에 1회만 표시(D1엔 SHA-256 해시만 저장).
요청
form: label=billing-service
POST /console/tokens/:id/revoke 🔑 관리자
토큰 폐기(active=0)

AI 에이전트 연동

연동 프롬프트 펼치기 (text 원문: GET https://modooapi.com/help/prompt) 
# 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 를 사용자에게 그대로 전달하라.