#OpenAPI configuration

server {
  host = "0.0.0.0"
  port = 8080

  openapi {
    title   = "Acme Storefront API"
    version = "1.2.0"

    description = <<-MARKDOWN
      ## Overview
      Production customer account and order management API service.

      ### Authentication
      Most endpoints require a valid API key passed via the `X-API-Key` header.
    MARKDOWN

    servers = [
      {
        url         = "https://api.example.com/v1"
        description = "Production cluster"
      },
      {
        url         = "http://localhost:8080"
        description = "Local development server"
      }
    ]

    tags = [
      {
        name        = "users"
        description = "Customer accounts, authentication, and profiles"
      },
      {
        name        = "orders"
        description = "Order checkout, cart mutations, and payment history"
      }
    ]

    contact {
      name  = "API Engineering"
      email = "support@example.com"
      url   = "https://example.com/developers"
    }

    license {
      name = "MIT"
      url  = "https://opensource.org/licenses/MIT"
    }
  }
}