openapi: 3.0.3
info:
  title: OpsxAPI Server
  version: 0.1.0
  description: Minimal health + HTTP proxy API
servers:
  - url: http://127.0.0.1:8787
paths:
  /health:
    get:
      summary: Health check
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok: { type: boolean }
                  service: { type: string }
  /v1/proxy/http:
    post:
      summary: Proxy an HTTP request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/HttpSpec"
      responses:
        "200":
          description: Proxied result
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HttpResult"
components:
  schemas:
    HttpSpec:
      type: object
      required: [method, url]
      properties:
        method:
          type: string
          enum: [GET, POST, PUT, PATCH, DELETE]
        url: { type: string }
        headers:
          type: object
          additionalProperties: { type: string }
        query:
          type: object
          additionalProperties: { type: string }
        body:
          type: object
          properties:
            mode: { type: string, enum: [none, json, raw, form, urlencoded] }
            raw: { type: string }
        timeoutMs: { type: integer }
    HttpResult:
      type: object
      properties:
        status: { type: integer }
        headers:
          type: object
          additionalProperties: { type: string }
        body: { type: string }
        timeMs: { type: number }
        size: { type: integer }