API-Dokumentation

Öffentliche, unauthentifizierte HTTP-Endpoints von elektro-ma24.de. Diese Dokumentation richtet sich an Entwickler und KI-Agenten. Maschinenlesbare OpenAPI-Beschreibung: /api/openapi.json. API-Katalog (RFC 9727): /.well-known/api-catalog.

Discovery

/.well-known/api-catalog – RFC 9727 / linkset+json
/.well-known/agent-skills/index.json – Agent Skills Index
/.well-known/mcp/server-card.json – MCP Server Card
/api/openapi.json – OpenAPI 3.1

POST `/api/contact`

Sendet eine neue Kundenanfrage. Wird vom Webformular mit Cloudflare Turnstile-Token aufgerufen; vertrauenswürdige Agenten dürfen den Token weglassen.

Request Body

{
  "name": "Anna Beispiel",
  "email": "[email protected]",
  "phone": "+49 200 1234567",
  "service": "photovoltaik",
  "message": "Bitte um Rückruf zu Photovoltaik."
}

Felder

name (string, erforderlich)
email (string, erforderlich, RFC 5322)
phone (string, optional)
service (string, optional) – einer von photovoltaik, netzwerktechnik, smart-home, elektroinstallationen, industrietechnik, haustechnik, e-ladestation, e-check, klingelanlagen, rauchmelder, beleuchtungstechnik, erdungstechnik
message (string, erforderlich, max. 5000 Zeichen)
turnstileToken (string, optional)

Antworten

200 – { "success": true }
400 – Validierungsfehler
403 – Turnstile-Prüfung fehlgeschlagen
500 – Serverfehler

GET `/api/health`

Antwortet immer mit 200 OK und einer JSON-Payload mit status und timestamp.

{ "status": "ok", "timestamp": "2026-05-03T12:00:00.000Z" }

Markdown-Negotiation

Browser bekommen HTML, Agenten können dieselben Seiten als Markdown anfordern, indem sie den Header Accept: text/markdown senden. Beispiel:

curl -H "Accept: text/markdown" https://www.elektro-ma24.de/