Risorse · Documentazione API
Kapy API e piattaforma di integrazione.
L'API Model-C (api.kapy.ch/v1) è operativa dal secondo trimestre del 2026. Tutte le app Kapy sono semplici consumatori di API. La documentazione pubblica completa developers.kapy.ch sarà disponibile nel terzo trimestre del 2026 — fino ad allora: contatto diretto per i partner.
Panoramica API
Cosa è già attivo oggi.
Endpoint v1 puliti per tenant Liefersoftware, portale clienti e widget di marketing. Panoramica su autenticazione, versioning ed endpoint pubblici.
Base e autenticazione
https://api.kapy.ch/v1 — Token Bearer con firma Ed25519 — Limite di frequenza 600 richieste/min/account — CORS per kapy.ch + origini partner.
Controllo delle versioni
Semver a livello di percorso API (/v1, in seguito /v2). Header Sunset per endpoint legacy. Scadenza Sunset attuale: 01/07/2026 per /api/legacy/*.
endpoint pubblici (oggi)
Oggi disponibile pubblicamente per l'acquisizione di lead, l'attivazione delle licenze e i controlli di integrità dei widget.
5 endpoint attiviEndpoint
Endpoint pubblici in dettaglio.
POST /widget/leads
Acquisizione di lead per il sito di marketing e il modulo della newsletter.
POST /widget/license/verify
Verifica della licenza per app Edge e portale clienti.
POST /widget/license/activate
Attivazione di una nuova licenza su un dispositivo.
GET /widget/stats
Statistiche aggregate dei widget per i widget del menu del pranzo incorporati.
GET /widget/health
Controllo dello stato per la pagina di stato e i test di uptime esterni.
Esempio di chiamata
Come si presenta l'invio di un lead.
Endpoint pubblico, non è necessario alcun token di autenticazione. CORS consentito per kapy.ch + origini partner.
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
Integrazioni pubbliche previste per il 2026/27.
Cosa verrà aggiunto dopo la documentazione pubblica developers.kapy.ch — nell'ordine in cui i gestori e i partner ne hanno fatto richiesta.
- Bexio & Abacus — Sincronizzazione del fatturato giornaliero per la contabilità (Q3 2026)
- Stripe e TWINT — Pagamenti online per la pagina degli ordini diretti (Q3 2026)
- Sistema Webhook — Streaming di eventi per fornitori terzi (Q4 2026)
- OAuth 2.0 per app di terze parti (2027)
- Specifiche OpenAPI pubbliche su
developers.kapy.ch/openapi.json
Integrazione dei partner già possibile oggi