Ressources · Documentation API

Kapy API et plateforme d'intégration.

L'API Modell-C (api.kapy.ch/v1) est opérationnelle depuis le deuxième trimestre 2026. Toutes les applications Kapy sont de simples consommateurs d'API. La documentation publique complète sera developers.kapy.ch au troisième trimestre 2026 — d'ici là : contact direct pour les partenaires.

kapy.ch?subject=API-Partner-Anfrage">[email protected] État du système

Aperçu des API

Ce qui est déjà en ligne aujourd'hui.

Points de terminaison v1 propres pour les locataires Liefersoftware, le portail client et les widgets marketing. Aperçu de l'authentification, de la gestion des versions et des points de terminaison publics.

Base & Auth

https://api.kapy.ch/v1 — Jeton Bearer avec signature Ed25519 — Limite de débit 600 requêtes/min/compte — CORS pour kapy.ch + origines partenaires.

Bearer · Ed25519 · 600 requêtes/min

Gestion des versions

Semver au niveau du chemin d'accès à l'API (/v1, plus tard /v2). En-tête Sunset pour les points de terminaison hérités. Date limite actuelle : 01/07/2026 pour les /api/legacy/*.

Semver · En-tête Sunset

les points de terminaison publics (aujourd'hui)

Disponible publiquement dès aujourd'hui pour la capture de prospects, l'activation de licence et les contrôles d'intégrité des widgets.

5 points de terminaison en ligne

Points de terminaison

Points de terminaison publics en détail.

POST /widget/leads Capture de prospects pour le site marketing et le formulaire de newsletter.

POST /widget/license/verify Vérification de licence pour les applications Edge et le portail client.

POST /widget/license/activate Activation d'une nouvelle licence sur un appareil.

GET /widget/stats Statistiques agrégées des widgets pour les widgets de menu du midi intégrés.

GET /widget/health Bilan de santé pour la page d'état et les sondes de disponibilité externes.

Exemple d'appel

À quoi ressemble un envoi de prospect.

Point de terminaison public, aucun jeton d'authentification requis. CORS autorisé pour kapy.ch + origines partenaires.

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..." }

Feuille de route

Intégrations publiques prévues pour 2026/27.

Ce qui viendra après la documentation publique developers.kapy.ch — dans l'ordre dans lequel les hébergeurs et les partenaires l'ont demandé.

Bexio & Abacus — Synchronisation du chiffre d'affaires quotidien pour la comptabilité (T3 2026)
Stripe & TWINT — Paiement en ligne pour la page de commande directe (T3 2026)
Système Webhook — Diffusion d'événements pour les fournisseurs tiers (T4 2026)
OAuth 2.0 pour les applications tierces (2027)
Spécification OpenAPI publique sur developers.kapy.ch/openapi.json

Feuille de route complète Journal des modifications

L'intégration des partenaires est déjà possible dès aujourd'hui

Comptable, agence web, revendeur de matériel informatique ? Écrivez-nous.

kapy.ch?subject=Demande de partenariat API">[email protected] Relations avec les investisseurs