07. OpenAPI 명세서 v1

JEDI 거버넌스 게이트웨이 — OpenAPI v3.0 명세서

Below is the machine-readable OpenAPI specification for the JEDI Governance Gateway API.

openapi: 3.0.3
info:
  title: JEDI 거버넌스 게이트웨이 API
  version: "1.0"
  description: 게이트웨이 API 계약 단일 소스 명세서
servers:
  - url: https://gateway.internal/v1
    description: 프로덕션
  - url: https://gateway-sandbox.internal/v1
    description: 샌드박스

paths:
  /auth/exchange:
    post:
      summary: SSO ID 토큰을 JWT 액세스 토큰으로 교환
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [sso_id_token]
              properties:
                sso_id_token: { type: string }

  /agent/invoke:
    post:
      summary: AI 작업 요청 제출
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [task_type, payload, department, client_channel]
              properties:
                task_type:
                  type: string
                  enum: [chat, code_pr, data_query, external_send]
                payload:
                  type: object
                  properties:
                    prompt: { type: string }
                    context_refs:
                      type: array
                      items: { type: string }
                department: { type: string }
                client_channel:
                  type: string
                  enum: [portal, slack, teams, ide_plugin, api]

  /approval/{approval_id}/decision:
    post:
      summary: 승인/반려 결정 제출
      parameters:
        - name: approval_id
          in: path
          required: true
          schema: { type: string, format: uuid }
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [decision]
              properties:
                decision: { type: string, enum: [approve, reject] }
                reason: { type: string }