Admin API

Admin HTTP API 位于 apis/admin-http，默认监听：

http://127.0.0.1:9710

Admin UI 默认监听 http://127.0.0.1:9720，并将浏览器侧 /api/* 代理到 Java Admin HTTP API。

认证

方法	路径	说明
GET	/api/auth/config	查看 Admin 认证是否启用
POST	/api/auth/login	使用用户名和密码登录，返回 Bearer Token
GET	/api/integration-key	查看 Executor Integration Key 是否已配置
POST	/api/integration-key	生成或轮换 Integration Key，明文只返回一次

登录请求：

{
  "username": "admin",
  "password": "admin"
}

响应：

{
  "accessToken": "<jwt>",
  "tokenType": "Bearer",
  "expiresIn": 3600
}

运行状态

方法	路径	说明
GET	/api/health	健康检查
GET	/api/overview	首页概览数据
GET	/api/plugins	插件加载和运行状态
GET	/api/audit	Admin 变更审计

任务

方法	路径	说明
GET	/api/jobs	任务列表
POST	/api/jobs	创建远程任务
GET	/api/jobs/{jobId}	查看任务详情
PUT	/api/jobs/{jobId}	更新任务
PATCH	/api/jobs/{jobId}	启停任务
DELETE	/api/jobs/{jobId}	删除任务
POST	/api/jobs/{jobId}/trigger	手动触发任务
GET	/api/jobs/{jobId}/history	查看任务变更历史

创建任务示例：

{
  "id": "billing-daily",
  "name": "Daily billing",
  "groupId": "billing",
  "handlerName": "billingHandler",
  "scheduleType": "CRON",
  "scheduleValue": "0 0 2 * * *",
  "zoneId": "Asia/Shanghai",
  "enabled": true
}

执行器

方法	路径	说明
GET	/api/executors	在线执行器实例
GET	/api/executor-definitions	逻辑执行器定义
POST	/api/executor-definitions	创建执行器定义
DELETE	/api/executor-definitions/{name}	删除执行器定义
POST	/api/executor-definitions/{name}/isolate	隔离执行器

执行记录和 Outbox

方法	路径	说明
GET	/api/executions	执行记录列表
GET	/api/executions/{executionId}	执行详情
GET	/api/executions/root/{rootExecutionId}	同一 root 的重试历史
POST	/api/executions/{executionId}/cancel	取消执行
POST	/api/executions/batch-cancel	批量取消
GET	/api/outbox/dead	死信派发记录
POST	/api/outbox/{outboxId}/requeue	重放死信派发
POST	/api/outbox/batch-requeue	批量重放

节点

方法	路径	说明
GET	/api/nodes	节点列表
POST	/api/nodes/{nodeId}/drain	开始节点 drain
POST	/api/nodes/{nodeId}/resume	恢复节点
GET	/api/nodes/{nodeId}/drain-status	查看 drain 状态

调度辅助

方法	路径	说明
POST	/api/schedules/preview	预览未来触发时间
GET	/api/schedules/timezones?query=Asia	搜索可用 IANA 时区

用户管理

方法	路径	说明
GET	/api/users	用户列表
POST	/api/users	创建用户
PUT	/api/users/{username}	更新用户
DELETE	/api/users/{username}	删除用户