Utiliser l'API ZapLink
Pour les sites sur mesure : créer des clients et des rendez-vous depuis ton propre code.
Cet article s'adresse à ton développeur. Si tu n'en as pas, commence par les widgets : ils couvrent la plupart des cas sans code.
L'API sert quand les widgets et les marqueurs ne suffisent pas : application sur mesure, logique métier particulière, ou intégration à un outil existant.
Obtenir une clé
Ouvre ZapLink
ZapLinkdans le menu.Génère une clé API
Elle n'est affichée qu'une seule fois. Note-la immédiatement.
Stocke-la côté serveur
Ne mets jamais la clé API dans le code de ta page web, ni dans un fichier JavaScript public. Une clé exposée donne à n'importe qui un accès en écriture à ton compte. Les appels à l'API doivent partir de ton serveur, jamais du navigateur du visiteur.
Pour du code côté navigateur, utilise les widgets ou les marqueurs : ils sont conçus pour ça et n'exposent aucune clé.
Principes
- Authentification par en-tête
Authorization: Bearer <clé>. - Corps et réponses en JSON.
- Toute écriture est rattachée à l'entreprise de la clé : une clé ne peut jamais toucher les données d'une autre entreprise.
- Le nombre d'appels est limité pour éviter les abus.
Ce que l'API permet
- Créer ou mettre à jour un client.
- Créer une demande de rendez-vous.
- Lire les prestations et les créneaux disponibles.
La référence complète — points d'entrée, champs, codes d'erreur — est disponible dans l'écran ZapLink de ton compte, avec les valeurs propres à ton entreprise.
Bonnes pratiques
Sois idempotent. Envoie un identifiant de ton côté pour qu'un double envoi ne crée pas deux fiches.
Gère les erreurs. Un appel peut échouer. Prévois une file d'attente et une nouvelle tentative, sinon tu perds des demandes.
Ne renvoie pas tout à chaque fois. Envoie les nouveautés, pas ton fichier entier à chaque synchronisation.
Fais tourner ta clé si tu soupçonnes une fuite, ou si le développeur qui l'avait quitte le projet.
Les données que tu envoies sont des données personnelles de tes clients. Le fait de passer par une API ne change rien à tes obligations : consentement, information des personnes, durée de conservation. Voir Supprimer un client et le RGPD.
Questions frequentes
Faut-il un développeur ?
Oui. Si tu n'en as pas, les widgets et les marqueurs couvrent la quasi-totalité des besoins sans écrire de code.
Cet article t'a-t-il aidé ?