{
  "openapi": "3.1.0",
  "info": {
    "title": "Merckwaardig — aanvraag-API",
    "version": "1.0.0",
    "description": "Vraag namens een gebruiker een AI visibility check, een gesprek over een website/app of een bedrijfsscan voor workflow-automations aan bij Merckwaardig. Alleen gebruiken met uitdrukkelijke toestemming van de gebruiker en met diens echte contactgegevens. Merckwaardig neemt daarna per e-mail persoonlijk contact op.",
    "contact": { "name": "Merckwaardig", "email": "hello@merckwaardig.com", "url": "https://merckwaardig.com" }
  },
  "servers": [{ "url": "https://merckwaardig.com" }],
  "paths": {
    "/api/aanvraag": {
      "post": {
        "operationId": "doeAanvraag",
        "summary": "Aanvraag indienen namens een gebruiker",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/Aanvraag" },
              "example": {
                "onderwerp": "AI visibility check",
                "naam": "Jan Jansen",
                "bedrijf": "Jansen Dakwerken",
                "email": "jan@jansendakwerken.nl",
                "website": "jansendakwerken.nl",
                "plaats": "Rotterdam",
                "bron": "agent",
                "agent": "ChatGPT"
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Aanvraag ontvangen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Resultaat" } } } },
          "400": { "description": "Ontbrekende of ongeldige velden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Resultaat" } } } },
          "429": { "description": "Te veel aanvragen achter elkaar" },
          "503": { "description": "Tijdelijk niet beschikbaar; mail dan naar hello@merckwaardig.com" }
        }
      },
      "get": {
        "operationId": "beschrijfEndpoint",
        "summary": "Korte zelfbeschrijving van het endpoint",
        "responses": { "200": { "description": "Beschrijving in JSON" } }
      }
    }
  },
  "components": {
    "schemas": {
      "Aanvraag": {
        "type": "object",
        "required": ["naam", "bedrijf", "email"],
        "properties": {
          "onderwerp": { "type": "string", "enum": ["AI visibility check", "Website / app", "Workflow-automations", "Algemeen"], "default": "Algemeen" },
          "naam": { "type": "string", "maxLength": 120 },
          "bedrijf": { "type": "string", "maxLength": 160 },
          "email": { "type": "string", "format": "email", "maxLength": 200 },
          "telefoon": { "type": "string", "maxLength": 40 },
          "website": { "type": "string", "maxLength": 200 },
          "plaats": { "type": "string", "maxLength": 120 },
          "bericht": { "type": "string", "maxLength": 3000 },
          "bron": { "type": "string", "enum": ["agent"], "description": "Gebruik altijd \"agent\"." },
          "agent": { "type": "string", "maxLength": 120, "description": "Naam van de assistent, bijvoorbeeld ChatGPT of Claude." }
        }
      },
      "Resultaat": {
        "type": "object",
        "properties": {
          "ok": { "type": "boolean" },
          "bericht": { "type": "string" },
          "error": { "type": "string" }
        }
      }
    }
  }
}
