Partner API : gérer les clés et les webhooks
Avec la Partner API, tu relies tes propres pages de réservation, applications et intégrations à STRYK. Tu crées des clés avec exactement les droits nécessaires et configures des webhooks.
Contents
Avant de commencer
- Tu as besoin du droit Gérer les canaux de distribution. Il te permet seulement de voir la ligne API sur la page Canaux.
- Clarifie quels domaines l’intégration doit lire ou écrire. Une clé ne reçoit que ces droits.
- Une intégration appelle la Partner API depuis son serveur. Ne place jamais la clé dans du code de navigateur ni dans une application. Les points d’accès, paramètres et exemples se trouvent dans la Documentation développeurs. Là, la section Authentification et périmètres explique ce que permet chaque droit.
- Les webhooks nécessitent un destinataire dont l’adresse commence par https://.
Ouvrir l’API
In STRYKCanaux
- Sous Connexions propres, choisis la ligne API avec la mention « Clés API et webhooks ». La fenêtre API s’ouvre.
- Choisis l’onglet Clés API ou Webhooks. Avec Documentation développeurs dans l’en-tête de la fenêtre, tu ouvres le portail développeurs.
- Onglets Clés API et Webhooks
- Clés avec droits
- Actions de la clé
Créer une clé API
In STRYKCanauxAPIClés API
- Choisis Créer une clé API. La fenêtre Créer une clé API s’ouvre.
- Saisis le Nom, par exemple « Page de réservation ».
- Sous Droits, choisis un modèle : Lecture seule (lecture de tous les domaines), Lecture et écriture (écriture là où c’est possible) ou Personnalisé. Avec Personnalisé, tu choisis pour chaque domaine Aucun accès, Lecture ou Écriture. Les domaines sont Hôtel et chambres, Disponibilité, Prix et tarifs, Réservations, Clients, Paiements et Factures. Écriture inclut Lecture. Les factures sont des justificatifs fiscaux de l’hôtel et ne peuvent être que lues par API.
- Facultatif : ouvre Avancé. Choisis l’Expiration : Sans expiration, 30 jours, 90 jours, 1 an ou Date (à partir de demain, au plus tard dans trois ans). Saisis sous Restriction IP une adresse ou un réseau CIDR par ligne, 20 au maximum. Vide : toutes les adresses sont autorisées. Sous Remarque, note un rappel interne.
- Choisis Créer. STRYK affiche Clé API créée avec la clé et la mention Visible uniquement maintenant.
- Copie la clé et enregistre-la par exemple dans ton gestionnaire de mots de passe. Choisis Terminé.
Gérer les clés
In STRYKCanauxAPIClés API
La liste affiche pour chaque clé le Nom, le début de la clé, les Droits, Créé, Dernière utilisation, Expiration et le statut : Actif, Expire bientôt, Révoqué ou Expiré. Sélectionne une clé pour voir les Droits, l’Expiration, les Adresses IP autorisées, la Limite de requêtes (requêtes par minute), l’Utilisation, les Requêtes récentes et l’Historique.
- Ouvre dans la ligne le menu Options.
- Choisis Régénérer si l’intégration doit recevoir une nouvelle clé avec les mêmes droits. Sous Clé actuelle, choisis Ancienne clé encore valable 24 h pour adapter l’intégration, ou Révoquer immédiatement. Confirme avec Régénérer. STRYK affiche la nouvelle clé une seule fois.
- Choisis Révoquer et confirme Révoquer la clé API ? pour bloquer immédiatement une clé. STRYK refuse alors les requêtes avec cette clé.
Configurer les webhooks
In STRYKCanauxAPIWebhooks
Un webhook envoie les événements choisis, signés, en HTTPS vers tes systèmes.
- Choisis Créer un webhook. La fenêtre Nouveau webhook s’ouvre.
- Saisis l’URL de destination, par exemple https://crm.nordlicht.invalid/hooks/stryk. L’adresse doit commencer par https://.
- Facultatif : saisis un Descriptif, par exemple « Réservations vers notre CRM ».
- Sous Événements, choisis au moins un élément : Réservation créée, Réservation modifiée, Réservation annulée, Client modifié, Disponibilité modifiée, Prix modifié, Paiement modifié ou Statut de chambre modifié. Avec Tout sélectionner et Annuler la sélection, tu choisis tous les éléments ou aucun.
- Choisis Créer un webhook. STRYK affiche Ton secret de signature une seule fois.
- Enregistre le secret dans ton destinataire. La documentation développeurs explique, dans Webhooks et vérification de la signature, comment le destinataire vérifie la signature.
- Choisis le webhook puis Envoyer un événement de test. STRYK affiche « L’événement de test est en cours de livraison. »
Gérer les webhooks
Ort: Canaux > API > Webhooks, sélectionner le webhook
- Avec l’interrupteur Envoi actif, tu mets le webhook en pause ou tu l’actives. Les webhooks en pause ne reçoivent aucun événement. Après l’activation, l’envoi reprend avec les nouveaux événements.
- 7 derniers jours, Dernier succès et Dernier échec montrent l’état. Sous Envois, tu vois chaque envoi avec son Statut HTTP et ses Tentatives. Avec Renvoyer, tu relances un envoi.
- Renouveler le secret crée un nouveau secret. L’ancien reste valable encore 24 heures, pour que tu puisses adapter le destinataire.
- Avec Modifier, tu changes l’adresse et les événements ; avec Supprimer et la confirmation Supprimer le webhook ?, tu le retires. Le journal d’envoi reste conservé 30 jours.
Vérifier le résultat
- Sur la clé, Dernière utilisation affiche la date dès que l’intégration l’utilise. Requêtes 24 h compte les requêtes.
- Pour le webhook, 7 derniers jours affiche « {Zahl} livrés, {Zahl} échoués », et l’événement de test figure sous Envois.
En cas de problème
| Ce que tu vois | Cause | Solution |
|---|---|---|
| « Choisis au moins un droit. » | Aucun domaine n’a de droit. | Choisis un modèle ou accorde à au moins un domaine Lecture ou Écriture. |
| « Merci de saisir un nom. » | Le Nom manque. | Saisis un nom. |
| « Merci de vérifier : » avec une adresse | Une adresse de la Restriction IP n’est pas valide. | Corrige l’adresse ou le réseau CIDR. 20 entrées au maximum sont autorisées. |
| « Choisis une date à partir de demain, au plus tard dans trois ans. » | La date d’expiration est hors de la période autorisée. | Choisis une date à partir de demain, située au plus à trois ans. |
| « L’adresse doit commencer par https:// » | L’URL de destination n’est pas une adresse HTTPS. | Saisis une adresse commençant par https://. |
| « Choisis au moins un événement. » | Le webhook n’a aucun événement. | Choisis au moins un élément sous Événements. |
| En pause suite à des erreurs répétées | Le destinataire ne répond pas avec un statut 2xx. | Vérifie que le destinataire est joignable, puis choisis Réactiver. |
| « Active le webhook pour envoyer un événement de test. » | Le webhook est en pause. | Active Envoi actif et envoie l’événement de test. |
| « La sélection n’a pas pu être chargée. Ferme la fenêtre et rouvre-la. » | La liste des droits et des événements n’est pas chargée. | Ferme la fenêtre et rouvre-la. |