跳转到主要内容
API 概览

三个流程端点和两个健康探针。

Markdown

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。 请在创建时保存它:之后读取该流程要靠它。

典型流程​

下一步:创建流程。