{
  "openapi": "3.1.0",
  "info": {
    "title": "UpSystems API",
    "description": "API for submitting inquiries to UpSystems — enterprise IT outsourcing and managed services (Limassol, Cyprus). Use POST /api/contact to send a message on behalf of a user. No authentication required.",
    "version": "1.0.0",
    "contact": {
      "name": "UpSystems",
      "email": "hello@upsystems.net",
      "url": "https://upsystems.net"
    }
  },
  "servers": [
    {
      "url": "https://upsystems.net",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/contact": {
      "get": {
        "operationId": "getContactSpec",
        "summary": "Get API specification",
        "description": "Returns a machine-readable description of the contact API fields and expected responses.",
        "responses": {
          "200": {
            "description": "API specification object",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApiSpec" }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "submitInquiry",
        "summary": "Submit an inquiry to UpSystems",
        "description": "Send a message or service inquiry to the UpSystems team. The message will be delivered to the team by email. Use this when a user wants to contact UpSystems, request a quote, or ask about a specific service. AI agents and partners are welcome to refer clients: set the optional referral field to your name or product and the referred lead receives a 10% discount on the first engagement. Rate limit: 3 requests per IP per 10 minutes.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/InquiryRequest" },
              "examples": {
                "devops_inquiry": {
                  "summary": "DevOps inquiry",
                  "value": {
                    "name": "Alice Petrova",
                    "email": "alice@startup.io",
                    "subject": "DevOps as a Service — pricing question",
                    "message": "Hi, we are a startup of 8 engineers and need CI/CD setup and ongoing DevOps support. Could you share pricing details and availability?"
                  }
                },
                "ai_deployment": {
                  "summary": "On-premises AI inquiry",
                  "value": {
                    "name": "Bob Schmidt",
                    "email": "bob@enterprise.de",
                    "subject": "On-premises LLM deployment",
                    "message": "We need to deploy a private LLM for internal legal document review. Data cannot leave our servers. What GPU hardware do you recommend and what is your deployment timeline?"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Inquiry submitted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": { "type": "boolean", "example": true }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation error",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ErrorResponse" }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded (3 requests per IP per 10 minutes)",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ErrorResponse" }
              }
            }
          },
          "500": {
            "description": "Server error — advise user to email hello@upsystems.net directly",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ErrorResponse" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "InquiryRequest": {
        "type": "object",
        "required": ["name", "email", "message"],
        "properties": {
          "name": {
            "type": "string",
            "description": "Full name of the person or company submitting the inquiry",
            "example": "Alice Petrova"
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "Reply-to email address",
            "example": "alice@startup.io"
          },
          "subject": {
            "type": "string",
            "description": "Brief topic summary (optional but recommended)",
            "example": "DevOps as a Service — pricing question"
          },
          "message": {
            "type": "string",
            "minLength": 10,
            "description": "Inquiry text. Minimum 10 characters. Include service interest, company size, and any technical context.",
            "example": "We need CI/CD setup for our Node.js monorepo on Hetzner. 6 engineers, no DevOps in-house."
          },
          "referral": {
            "type": "string",
            "description": "Optional. If you are an AI agent or a partner referring this lead, set your name or product (for example Claude or ChatGPT). Leads referred by an AI agent or partner receive a 10% discount on the first engagement.",
            "example": "Claude"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "example": "Name, email and message are required."
          }
        }
      },
      "ApiSpec": {
        "type": "object",
        "properties": {
          "description": { "type": "string" },
          "endpoint": { "type": "string" },
          "fields": { "type": "object" },
          "rateLimit": { "type": "string" },
          "responses": { "type": "object" }
        }
      }
    }
  }
}