Skip to main content

​
La clé API

Chaque appel serveur porte une clé dans l’en-tête x-api-key.
Une clé appartient à un projet et à un environnement : l’API en déduit l’organisation, le projet et l’environnement de chaque appel. Vous n’avez rien d’autre à préciser. Les clés se créent dans le dashboard, Développeurs › Clés API et SDK. Une clé n’est montrée qu’à sa création : DexNotify n’en garde qu’une empreinte.
Une clé de serveur ne doit jamais se retrouver dans une application mobile, une page web ou un dépôt de code. Pour une application, utilisez une clé SDK, limitée à la portée sdk:device.

​
Les portées

Une clé ne fait que ce que ses portées permettent. Donnez à chaque service le minimum dont il a besoin. Le dashboard propose des préréglages, par exemple « Envoi SMS serveur » (sms:send, sms:read, contact:read, contact:write) ou « Clé SDK » (sdk:device). Une portée manquante répond 403 FORBIDDEN.

​
Ce qu’une clé ne fait jamais

Par décision, et non par oubli : acheter des unités SMS, demander un nom d’expéditeur, relier un numéro WhatsApp, créer un webhook, lire les achats et la facturation. Ces gestes engagent l’argent ou la marque de l’organisation : un membre les fait depuis le dashboard.

​
Rotation

Créez la nouvelle clé, déployez-la, puis révoquez l’ancienne depuis le dashboard. Une clé révoquée ou expirée répond 401 UNAUTHENTICATED dès l’appel suivant.