Skip to main content

​
Clés API

L’API Xalantis utilise des clés API pour l’authentification. Chaque clé est liée à une organisation et hérite de ses permissions.

​
Format de la clé

Les clés API suivent le format : 
sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  • sk_ : préfixe standard
  • live_ : indique une clé de production
  • 32 caractères aléatoires

​
Utilisation

Incluez votre clé dans le header Authorization avec le préfixe Bearer : 
curl -H "Authorization: Bearer sk_live_XXXXXXXXXX" \
     -H "Content-Type: application/json" \
     https://app.xalantis.com/api/tickets

​
Gestion des clés

​
Générer une clé

  1. Accédez à Paramètres > Développeurs
  2. Cliquez sur Générer une clé
  3. Remplissez le nom et l’URL webhook (optionnel)
  4. Cliquez sur Continuer
  5. Entrez le code OTP reçu par email
  6. Important : Copiez immédiatement votre clé
La clé n’est affichée qu’une seule fois lors de sa création. Pour des raisons de sécurité, elle est stockée de manière hashée et ne peut plus être récupérée. Si vous la perdez, vous devrez en générer une nouvelle.

​
Révoquer une clé

Pour révoquer une clé :
  1. Cliquez sur l’icône 🗑️ à côté de la clé
  2. Confirmez la révocation
La révocation est irréversible. Toutes les applications utilisant cette clé cesseront de fonctionner.

​
Sécurité

Les clés API sont hashées avec SHA-256 avant d’être stockées. Seul un préfixe de 12 caractères est conservé pour l’identification visuelle.
La création de clé nécessite une vérification par code OTP envoyé par email.
L’API n’accepte que les connexions HTTPS. Les requêtes HTTP seront refusées.
Chaque utilisation de la clé met à jour le timestamp “Dernière utilisation” visible dans le tableau de bord.
Les clés peuvent avoir une date d’expiration (fonctionnalité à venir).

​
Erreurs d’authentification

CodeMessageSolution
401Unauthorized: Missing or invalid tokenVérifiez que le header Authorization est présent et correct
401Unauthorized: API Key expiredGénérez une nouvelle clé
403Votre plan ne permet pas l'utilisation des clés APIPassez à un plan supérieur