L'API de Kanal vous permet d'interagir par programmation avec les fonctionnalités de la plateforme. Pour garantir la confidentialité de vos données et la sécurité de vos communications WhatsApp, chaque requête envoyée à nos serveurs doit être authentifiée.
Vos clés API disposent de privilèges étendus sur votre compte Kanal. Elles permettent d'envoyer des messages, d'accéder à vos listes de contacts et de consulter vos statistiques. Il est donc impératif de les traiter avec la plus grande vigilance.
Ne partagez jamais vos clés API secrètes dans des zones accessibles publiquement (comme des dépôts GitHub publics).
N'intégrez jamais vos clés directement dans du code côté client (JavaScript s'exécutant dans le navigateur).
En cas de compromission suspectée d'une clé, révoquez-la immédiatement depuis votre tableau de bord Kanal et générez-en une nouvelle.
Toutes les requêtes API doivent être effectuées via le protocole HTTPS. Pour des raisons de sécurité, toute tentative d'appel effectuée via le protocole HTTP classique échouera systématiquement.
L'utilisation du chiffrement TLS (HTTPS) garantit que les données transitant entre votre serveur et l'API Kanal ne peuvent pas être interceptées par un tiers.
L'authentification à l'API Kanal s'effectue via le mécanisme Bearer Auth (HTTP Bearer Authentication). Vous devez fournir votre clé API en tant que jeton (token) dans l'en-tête de votre requête HTTP.
L'en-tête de votre requête doit être structuré de la manière suivante :
Authorization: Bearer <VOTRE_CLE_API>
Voici un exemple type de la structure d'une requête authentifiée vers notre API :
curl -X GET "[https://api.getkanal.com/v1/endpoint](https://api.getkanal.com/v1/endpoint)" \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json"
Si une requête est envoyée sans en-tête d'autorisation ou avec une clé API invalide/révoquée, le serveur de Kanal renverra une erreur d'authentification (généralement un code d'état HTTP 401 Unauthorized). Assurez-vous que le mot "Bearer" précède bien votre clé et qu'aucun espace superflu n'est présent dans l'en-tête.