API & Webhooks

Avec l'API et les webhooks de Salonnare, vous connectez votre salon à d'autres logiciels : votre logiciel de comptabilité, votre propre site web, un service de newsletter ou un tableau de bord sur mesure. Pas besoin d'être développeur pour comprendre à quoi ils servent -- cette page l'explique tranquillement.

Qu'est-ce qu'une API ?

Une API (Application Programming Interface) est un accord qui permet à deux programmes de communiquer entre eux. Là où vous cliquez sur un bouton dans l'application pour charger un rendez-vous, un autre programme peut demander les mêmes données via l'API -- automatiquement et sans intervention manuelle.

Exemples pratiques pour un salon :

• Votre logiciel de comptabilité récupère automatiquement votre chiffre d'affaires chaque nuit.
• Votre propre site web affiche vos prestations et vos prix, directement depuis Salonnare.
• Un partenaire d'intégration synchronise votre fichier clients.

L'accès à l'API passe par une clé API : un code secret qui prouve que la demande vient de vous. Traitez cette clé comme un mot de passe.

Créer une clé API

1. Allez dans Paramètres -> API & Webhooks.
2. Cliquez sur Nouvelle clé API.
3. Donnez à la clé un nom reconnaissable (par exemple "Comptabilité") et choisissez les droits : lecture seule ou lecture et écriture.
4. Copiez la clé immédiatement et conservez-la en lieu sûr. Pour des raisons de sécurité, Salonnare n'affiche la clé complète qu'une seule fois.

Vous pensez qu'une clé a fuité ? Supprimez-la aussitôt -- toute intégration utilisant cette clé s'arrête immédiatement.

Qu'est-ce qu'un webhook ?

Un webhook est l'inverse de l'API. Au lieu que vous récupériez des données, Salonnare envoie automatiquement un message à une adresse (URL) que vous avez indiquée dès qu'un événement se produit. L'autre logiciel n'a plus besoin de demander sans cesse "y a-t-il du nouveau ?" -- il reçoit un signal de lui-même.

Salonnare peut envoyer notamment ces événements :

• booking.created -- un nouveau rendez-vous a été créé
• booking.updated -- un rendez-vous a été modifié
• booking.cancelled -- un rendez-vous a été annulé
• payment.received -- un paiement a été reçu
• client.created -- un nouveau client a été créé
• client.updated -- les données d'un client ont été modifiées

Configurer un webhook

1. Allez dans Paramètres -> API & Webhooks et ouvrez l'onglet Webhooks.
2. Cliquez sur Nouveau webhook.
3. Saisissez l'URL vers laquelle Salonnare enverra les notifications (votre partenaire d'intégration ou développeur vous la fournit).
4. Choisissez les événements auxquels vous voulez réagir.
5. Enregistrez. Vous pouvez ensuite consulter les journaux d'envoi pour vérifier que les notifications arrivent correctement.

Travailler en sécurité

• Ne partagez jamais vos clés API publiquement (ni par e-mail, ni dans des captures d'écran, ni dans du code publié en ligne).
• Ne donnez à une intégration que les droits dont elle a vraiment besoin -- choisissez la lecture seule lorsque c'est possible.
• Supprimez les clés et webhooks que vous n'utilisez plus.

Comme Salonnare traite vos données dans l'UE et que vous décidez vous-même quelles intégrations ont accès, vous gardez le contrôle total de vos données. Besoin d'aide pour une intégration ? N'hésitez pas à nous contacter via la page d'assistance.