Premiers pas
Authentification
Chaque requête est authentifiée par une clé API envoyée dans l’en-tête Authorization. Aucune session ni aucun échange de jeton à gérer.
L’en-tête Authorization
Envoyez votre clé précédée du préfixe App et d’une espace, sur chaque requête :
HTTP
Les requêtes partent vers l’URL de base affichée à côté de vos clés dans le tableau de bord. Utilisez toujours HTTPS.
check-key.ts
Gérer vos clés
- Une clé par environnement. Créez des clés distinctes pour le développement, la préproduction et la production, pour en révoquer une sans toucher aux autres.
- Rotation sans interruption. Créez la nouvelle clé, déployez-la, puis révoquez l’ancienne. Les deux fonctionnent entre-temps.
- Révocation en cas de fuite. Si une clé se retrouve dans un log, un commit ou un ticket, révoquez-la tout de suite dans le tableau de bord. Les requêtes qui l’utilisent échouent immédiatement.
Gardez vos clés côté serveur
Une clé peut envoyer des messages et passer des appels facturés sur votre compte. Appelez Pulsr depuis votre backend, une fonction serverless ou une file de tâches, jamais directement depuis un navigateur ou une application mobile. Si votre frontend doit déclencher un message, exposez votre propre endpoint qui vérifie qui fait la demande, puis appelle Pulsr.
Erreurs d’authentification
| Statut | Signification |
|---|---|
401 Unauthorized | L’en-tête est absent ou mal formé, ou la clé n’existe pas ou a été révoquée. |
403 Forbidden | La clé est valide mais n’a pas accès à cet endpoint ou à cette fonctionnalité. |
Réponse · 401 Unauthorized