API 概览
三个流程端点和两个健康探针。
Human Plugin 通过您所配置的端口(默认 8080)以纯 HTTP 提供服务。基础 URL 取决于您在网络内部暴露容器的位置,例如 http://human-plugin.internal:8080。
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /v1/processes | 创建流程,使用其中一种流程类型 |
GET | /v1/processes/{id} | 获取流程 |
GET | /v1/processes/{id}/selfie | 获取自拍照 |
GET | /health/live | 存活探针。参见健康检查与监控 |
GET | /health/ready | 就绪探针(数据库 ping) |
没有用于列出、删除或搜索流程的端点,也没有 webhook 接收器。
适用于每次调用的规则
- 没有认证头。 Human Plugin 不会验证调用方。请改为限制网络访问:参见网络与安全。
- 仅支持 JSON,字段名使用 camelCase。
- 响应带有
Cache-Control: no-store。 - 错误使用统一的信封格式
{"message": "INVALID_REQUEST", "details": []}。参见错误与重试。 id是 Human Plugin 的流程 id。 请在创建时保存它:之后读取该流程要靠它。
典型流程
下一步:创建流程。