Public API
Automatisieren Sie alles, was wiederholbar ist.
REST-API und Webhooks für jeden mekyn-Endpunkt — Inhalte, SEO-Reports, Leads, Builds, Domain-Aktionen. Bauen Sie eigene Tools, sync zu Notion oder Slack, oder integrieren Sie mekyn als Backend Ihres Stacks.
Sechs Bausteine für Automation
-
REST-API
Vollständig dokumentierte REST-Endpunkte für CRUD auf Sites, Pages, Blocks, Domains, Leads — JSON-In, JSON-Out.
-
Webhooks
Events: site.published, lead.received, seo.report.ready, backlink.detected, social.posted — signiert mit HMAC-SHA256.
-
OAuth 2.0
Token-basierte Authentifizierung mit Scopes (read:sites, write:pages, manage:leads). Token-Rotation per Klick.
-
Rate-Limits transparent
1.000 Requests/Stunde im Business-Tarif, 10.000 im Enterprise. Header X-RateLimit-* zeigen verbleibende Quote.
-
OpenAPI-Spezifikation
Vollständige OpenAPI-3.1-Spec — generiert automatisch typsichere Clients in TypeScript, Python, Go, Ruby.
-
GraphQL (Roadmap)
GraphQL-Endpoint geplant für Q3 2026. REST bleibt parallel verfügbar — keine Breaking Changes.
Beispiel-Workflows.
Vier Anwendungen, die unsere Beta-Tester schon laufen haben.
-
CMS-Sync aus Notion
Ein Cron-Job liest Ihre Notion-Pages und pushed Inhalte als mekyn-Blocks ins CMS. Notion ist Quelle, mekyn ist Frontend.
-
Lead-Stream zu Slack
Webhook „lead.received" pingt einen Slack-Kanal mit Lead-Details und Direkt-Link zum Lead in mekyn.
-
SEO-Report in Looker Studio
Daily-Cron zieht SEO-Metriken via API und schiebt sie in BigQuery — Looker visualisiert.
-
Auto-Deploy bei Git-Push
GitHub Action ruft API-Endpunkt „site.rebuild" — Build startet, Site ist in 30 Sekunden live.
Beispiel · cURL
curl https://api.mekyn.com/v1/sites \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"
# {
# "data": [
# { "id": "muehler-sanitaer", "domain": "muehler-sanitaer.de", "status": "live" },
# { "id": "praxis-dr-schmidt", "domain": "praxis-schmidt.de", "status": "live" }
# ],
# "meta": { "total": 2, "page": 1 }
# } Häufige Fragen zur API
-
In welchen Tarifen ist die API enthalten?
Lese-Zugriff (read-only) ab Tarif Professional. Schreib-Zugriff und Webhooks ab Tarif Business. Höhere Rate-Limits und SLA ab Enterprise.
-
Wo finde ich die Dokumentation?
Die OpenAPI-Spec liegt unter <a href="https://api.mekyn.com/openapi.json" class="underline">api.mekyn.com/openapi.json</a>, interaktive Doku unter <a href="https://docs.mekyn.com/api" class="underline">docs.mekyn.com/api</a>. Beide Endpoints sind in Aufbau — der Frühzugang läuft über persönlichen Onboarding-Termin.
-
Sind Webhooks zuverlässig?
Ja. Bei Fehler-Response (>=500 oder Timeout) retry mit Exponential Backoff bis zu 24 Stunden. Failed Payloads liegen in einer Dead-Letter-Queue, die Sie im Dashboard einsehen können.
-
Was ist mit Rate-Limits?
Business: 1.000/h. Enterprise: 10.000/h, individuelle Erhöhung möglich. Header X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset zeigen den Status. Bei Überschreitung HTTP 429 mit Retry-After.
-
Ist die API DSGVO-konform?
Ja. Alle Endpunkte laufen ausschließlich auf EU-Servern. Audit-Logs aller API-Calls liegen 90 Tage. Personenbezogene Daten in Webhook-Payloads sind verschlüsselt at-rest.
Bereit für API-Zugang?
Ab Business-Tarif inklusive. Frühzugang zu neuen Endpunkten über persönlichen Onboarding-Termin.