API externe et clés API
Connexion sécurisée à POS et autres systèmes externes.
Avec l’API externe, ta caisse ou une autre application maison se connecte à stmpr en toute sécurité. Tu peux chercher des clients, donner ou retirer des tampons, valider des récompenses et récupérer des statistiques.
La connexion est authentifiée par une clé API liée à un magasin et, si nécessaire, à une carte de fidélité spécifique. N’accordez que les autorisations nécessaires pour la clé.
Pour éviter les tamponnages répétés, une clé d’idempotence unique peut être utilisée pour chaque requête d’écriture.
https://stmpr.io/dashboard/developers
https://stmpr.io/docs/api
Emplacement de l’image: API documentation pour ajouter un tampon avec une demande d’exemple
Étape par étape
- Va dans le menu Intégrations API la page des clés.
- Créez une nouvelle clé, donnez-lui un nom reconnaissable, et sélectionnez les autorisations nécessaires.
- Si l’intégration concerne un seul programme, limitez la clé de cette carte de fidélité.
- Copiez la clé secrète et stockez-la dans le gestionnaire de secrets du POS ou du serveur. Plus tard, la valeur complète n’est plus affichée.
- Respectez les exigences de certification, de limitation de vitesse et d’idempotence dans la documentation API.
- Testez séparément la recherche d’invités, le tamponnage, l’annulation et le remboursement avant de lancer la recherche.