openapi: 3.0.3
info:
  title: Apache HttpComponents Client Configuration API
  version: 5.3.0
  description: Reference API specification for Apache HttpComponents HTTP client library, covering request execution, connection management, authentication, and proxy configuration.
  contact:
    email: dev@hc.apache.org
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://api.example.com
  description: Example target server for HttpComponents client
tags:
- name: Configuration
  description: Client configuration operations
paths:
  /configure/connection:
    put:
      operationId: configureConnection
      summary: Apache HttpComponents Configure Connection
      description: Update connection pool and timeout configuration for the HTTP client.
      tags:
      - Configuration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectionConfig'
      responses:
        '200':
          description: Configuration updated
  /configure/proxy:
    put:
      operationId: configureProxy
      summary: Apache HttpComponents Configure Proxy
      description: Configure an HTTP proxy for outbound requests from the HttpComponents client.
      tags:
      - Configuration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProxyConfig'
      responses:
        '200':
          description: Proxy configured
components:
  schemas:
    ProxyConfig:
      type: object
      description: HTTP proxy configuration for Apache HttpComponents client
      properties:
        host:
          type: string
          description: Proxy hostname
          example: proxy.example.com
        port:
          type: integer
          description: Proxy port
          example: 8080
        scheme:
          type: string
          description: Proxy scheme (http or https)
          example: http
        username:
          type: string
          description: Proxy authentication username
          example: proxyuser
        password:
          type: string
          description: Proxy authentication password
          example: ''
    ConnectionConfig:
      type: object
      description: Connection configuration for Apache HttpComponents client
      properties:
        connectTimeout:
          type: integer
          description: Connection timeout in milliseconds
          example: 5000
        socketTimeout:
          type: integer
          description: Socket read timeout in milliseconds
          example: 30000
        maxConnections:
          type: integer
          description: Maximum total connections in pool
          example: 200
        maxConnectionsPerRoute:
          type: integer
          description: Maximum connections per route
          example: 20
        keepAliveTimeout:
          type: integer
          description: Keep-alive timeout in milliseconds
          example: 60000