A AisOpsFlow Enterprise 문서 공식 제품 문서 및 사용자 안내서

참조

API 참조

AisOpsFlow Enterprise가 노출하는 주요 API 그룹과 엔드포인트 계열, 용도를 요약합니다.

API 스타일

AisOpsFlow Enterprise는 주로 다음을 위한 HTTP API를 제공합니다.

  • 인증
  • 워크플로 관리
  • 실행 검토
  • 수신자와 그룹 관리
  • Kakao 템플릿과 테스트 경로
  • 플랫폼 운영
  • LLM 계획과 dispatch

Core ↔︎ Runner 전송은 별도이며 버전된 gRPC 프로토콜을 사용합니다.

인증

주요 로그인 엔드포인트

  • POST /api/login
  • POST /api/logout

로그인으로 받은 JWT는 다음처럼 사용합니다.

Authorization: Bearer <token>

워크플로

  • GET /api/workflows
  • PUT /api/workflows/{id}
  • POST /api/workflows/{id}/enable
  • POST /api/workflows/{id}/disable
  • POST /api/hooks/{workflowId}

실행

  • GET /api/executions
  • GET /api/executions/{id}
  • POST /api/executions/{id}/retry

수신자와 그룹

  • recipient CRUD
  • group CRUD
  • group membership 관리

알림 라우팅은 단순 채널 주소만으로 끝나지 않기 때문에 이 부분이 중요합니다.

Kakao 템플릿과 테스트

  • template CRUD
  • POST /api/kakao/send-test

운영

  • GET /api/ops/managed-providers
  • PUT /api/ops/managed-providers/{providerKind}
  • DELETE /api/ops/managed-providers/{providerKind}
  • GET /api/ops/backup/export
  • POST /api/ops/backup/validate
  • POST /api/ops/backup/import
  • GET /api/ops/runner-denylist
  • PUT /api/ops/runner-denylist/{runnerId}
  • DELETE /api/ops/runner-denylist/{runnerId}

에이전트와 계획 API

  • POST /api/agent/llm-plan
  • POST /api/agent/execute-planned-job
  • POST /api/agent/llm-plan-and-dispatch
  • GET /api/agent/decision-traces
  • GET /api/runner/job-results/{jobId}

이 API들은 구조화된 계획 생성, 정책 검사를 거친 dispatch, 에이전트 기반 실행의 추적성을 위해 사용합니다.

헬스

  • GET /healthz

플러그인 계약 표면

플러그인은 내부 메서드 호출이 아닙니다. 문서화된 계약을 가진 외부 HTTP 서비스입니다.

대표 예시:

  • POST /send
  • POST /kakao/alimtalk/send

이 섹션 사용 방법

  • 온보딩 시에는 이 페이지를 엔드포인트 계열 지도처럼 사용합니다.
  • 페이로드 예시와 planning 의미론은 상세 API 문서를 함께 봅니다.

상세 API 문서

상세 API 문서는 현재 영문 원문을 함께 유지합니다.

관련 문서