API 개요
프로세스 엔드포인트 3개와 헬스 프로브 2개.
Human Plugin은 사용자가 설정한 포트(기본값 8080)에서 일반 HTTP로 제공됩니다. 기본 URL은 네트워크 내부에서 컨테이너를 노출하는 주소이며, 예를 들어 http://human-plugin.internal:8080입니다.
| Method | Path | 용도 |
|---|---|---|
POST | /v1/processes | 프로세스 생성, 플로우 중 하나를 사용 |
GET | /v1/processes/{id} | 프로세스 조회 |
GET | /v1/processes/{id}/selfie | 셀피 조회 |
GET | /health/live | 라이브니스. 상태 확인 및 모니터링 참조 |
GET | /health/ready | 준비 상태(데이터베이스 ping) |
프로세스를 목록으로 조회하거나, 삭제하거나, 검색하는 엔드포인트는 없으며, 웹훅 수신기도 없습니다.
모든 호출에 적용되는 규칙
- 인증 헤더 없음. Human Plugin은 호출자를 검증하지 않습니다. 대신 네트워크 접근을 제한하세요. 네트워킹 및 보안을 참조하세요.
- JSON만 사용하며, 필드 이름은 camelCase입니 다.
- 응답은
Cache-Control: no-store입니다. - 오류는 하나의 envelope인
{"message": "INVALID_REQUEST", "details": []}를 사용합니다. 오류 및 재시도를 참조하세요. id는 Human Plugin의 프로세스 id입니다. 생성할 때 보관해 두세요. 나중에 프로세스를 조회하는 데 사용합니다.
일반적인 순서
다음: 프로세스 생성.