Aller au contenu principal
Compte & paramètres

API développeur, clés et webhooks

Créez des clés API et des webhooks pour intégrer Stay'Core à vos outils (fonctionnalité Business).

Aperçu de l'écran Stay'Core

La page API Développeur permet d'intégrer Stay'Core à vos outils via une API REST. L'accès API est disponible sur le plan Business (et plan personnalisé).

Clés API

  • Cliquez sur « Nouvelle clé », donnez-lui un nom, sélectionnez les scopes (permissions par ressource : réservations, logements, tâches, messagerie, factures, cautions, Nuki, webhooks, en lecture et/ou écriture).
  • Vous pouvez restreindre la clé à des IPs (ou plages CIDR) et à des logements précis, et définir une date d'expiration.
  • La clé complète n'est affichée qu'une seule fois à la création : copiez-la immédiatement. Les clés sont hashées en SHA-256, jamais stockées en clair. En cas de perte, générez-en une nouvelle.

Webhooks

  • Créez un webhook avec une URL HTTPS et les événements à recevoir (réservation créée / modifiée / annulée, voyageur arrivé, message reçu).
  • Chaque payload est signé HMAC SHA-256 dans l'en-tête X-StayCore-Signature ; vérifiez-le côté récepteur avec votre webhook secret (affiché une seule fois, rotatable).
  • Les livraisons en échec sont retentées 5 fois (30 s, 2 min, 10 min, 1 h, 6 h) avant désactivation automatique.

Les onglets Logs et Documentation complètent l'outillage développeur.

Cet article a-t-il répondu à votre question ?