Resources · API-Docs

Kapy API & Integration Platform.

Modell-C-API (api.kapy.ch/v1) ist seit Q2 2026 produktiv. Alle Kapy-Apps sind reine API-Konsumenten. Vollständige Public-Doku auf developers.kapy.ch kommt Q3 2026 — bis dahin: direkter Kontakt für Partner.

[email protected] System-Status

API-Übersicht

Was heute schon live ist.

Saubere v1-Endpoints für Liefersoftware-Tenants, Customer-Portal und Marketing-Widgets. Auth, Versionierung und Public-Endpoints im Überblick.

Base & Auth

https://api.kapy.ch/v1 — Bearer-Token mit Ed25519-Signatur — Rate-Limit 600 req/min/account — CORS für kapy.ch + Partner-Origins.

Bearer · Ed25519 · 600 req/min

Versionierung

Semver auf API-Pfad-Ebene (/v1, später /v2). Sunset-Header für Legacy-Endpoints. Aktuelle Sunset-Frist: 2026-07-01 für /api/legacy/*.

Semver · Sunset-Header

Public-Endpoints (heute)

Heute öffentlich abrufbar für Lead-Capture, Lizenz-Aktivierung und Widget-Health-Checks.

5 Endpoints live

Endpoints

Public-Endpoints im Detail.

POST /widget/leads Lead-Capture für Marketing-Site und Newsletter-Form.

POST /widget/license/verify Lizenz-Verifikation für Edge-Apps und Customer-Portal.

POST /widget/license/activate Aktivierung einer neuen Lizenz auf einem Gerät.

GET /widget/stats Aggregierte Widget-Stats für eingebettete Mittagsmenü-Widgets.

GET /widget/health Health-Check für Status-Page und externe Uptime-Probes.

Beispiel-Call

Wie ein Lead-Submit aussieht.

Public-Endpoint, kein Auth-Token nötig. CORS für kapy.ch + Partner-Origins erlaubt.

POST https://api.kapy.ch/v1/widget/leads
Content-Type: application/json

{
  "type": "newsletter",
  "email": "[email protected]",
  "source": "footer-newsletter",
  "page": "/index.html"
}

200 OK
{ "ok": true, "id": "lead_01H..." }

Roadmap

Geplante Public-Integrationen 2026/27.

Was nach der Public-Doku in developers.kapy.ch dazukommt — in der Reihenfolge, in der Wirte und Partner danach gefragt haben.

Bexio & Abacus — Tagesumsatz-Sync für Buchhaltung (Q3 2026)
Stripe & TWINT — Online-Payment für Direkt-Bestellseite (Q3 2026)
Webhook-System — Event-Streaming für Drittanbieter (Q4 2026)
OAuth 2.0 für Drittanbieter-Apps (2027)
Public OpenAPI-Spec auf developers.kapy.ch/openapi.json

Voll-Roadmap Changelog

Partner-Integration heute schon möglich

Buchhalter, Web-Agentur, Hardware-Reseller? Schreib uns.

[email protected] Investor Relations