Intégration des développeurs
Le 7stamp Integration API permet à un CRM, une plateforme de commerce électronique, un POS, un backend personnalisé ou un outil d'automatisation de gérer cartes de fidélité portefeuille avec l'identifiant de contact que votre propre système utilise déjà. C'est l'option universelle lorsqu'une intégration spécialisée n'existe pas.
La base API URL est https://api.7loc.com/cards-api. Authentifiez chaque demande avec une clé API en tant que jeton Bearer. Utilisez la référence liée OpenAPI pour les schémas de demande et de réponse en direct avant de créer une logique de production.
Le API est le côté écriture de la pile d'intégration. Utilisez-le chaque fois que votre propre logiciel doit rester la source opérationnelle de vérité pendant que 7stamp gère la couche de fidélité du portefeuille.
Générez un lien de carte de portefeuille personnel pour n'importe quel client de votre système. Distribuez-le via votre propre e-mail, SMS, push ou via un flux intégré à l'application. Le client ouvre le lien et enregistre la carte au Apple Wallet ou au Google Wallet.
Lorsqu'un achat est conclu dans votre POS personnalisé, lorsqu'une commande en ligne est payée sur votre site Web ou lorsqu'un service est effectué dans votre système de réservation, appelez le API pour créditer les tampons. La carte se met à jour en quelques secondes.
Émettez un bon unique à un client spécifique, créez des flux de récompenses prêts pour la campagne et récupérez le statut du bon dans les systèmes qui gèrent les finances et la qualité du service.
Ce sont les routes publiques API derrière le Actions Make et Zapier. Lisez le schéma exact dans la référence API; ne déduisez pas les noms de champs d’un point de terminaison différent.
POST /cards/invite Crée une nouvelle installation personnelle URL pour un contact externe.
POST /cards/invite/bulk Crée jusqu'à 100 liens d'invitation dans un lot contrôlé.
GET /cards Recherche les enregistrements de cartes par identifiant de contact externe.
GET /cards/{user_card_id} Renvoie l'état complet d'une carte par son interne 7stamp ID.
POST /cards/scan Ajoute des tampons par carte ID ou External ID et enregistre la commande source une fois fournie.
GET /templates Répertorie les modèles de cartes disponibles sur le lieu de travail de la clé/profile.
GET /templates/{template_id}/design Lit les paramètres visuels d'un modèle de carte connu.
POST /vouchers/issue Émet un bon à un propriétaire de carte.
POST /messages/send Envoie un message push de carte de portefeuille et/or un contenu par courrier électronique à un propriétaire de carte.
Ce sont de vrais écrans 7stamp Admin. Ouvrez API & Intégrations, ajoutez une clé, puis copiez-la dans une connexion secrète sécurisée côté serveur ou une connexion d'automatisation.
Créez la clé dans 7stamp Admin sous API Integrations → API Keys → Add API Key. Une clé appartient à un seul lieu de travail/profile, créez donc des clés distinctes pour le développement et la production lorsque la configuration de votre compte le permet. Faites pivoter ou révoquez l'accès depuis le tableau de bord si un secret est exposé.
External ID est l'identifiant de contact stable de votre système: un CRM ID, un client UUID, un numéro de téléphone ou un e-mail. Préférez un système immuable ID. Ajoutez éventuellement External Source pour éviter les collisions entre les systèmes et rendre explicite la corrélation des webhooks.
Lorsque le profil a un modèle actif, template_id peut être omis et 7stamp le sélectionne automatiquement. Lorsqu'il dispose de plusieurs modèles actifs, transmettez le template_id prévu. Lisez d'abord GET /templates plutôt que de coder en dur un ID deviné.
bash curl -X POST "https://api.7loc.com/cards-api/cards/invite" \
-H "Authorization: Bearer YOUR_7STAMP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}'Connectez-vous à 7stamp Admin et créez une clé: API Integrations → API Keys → Add API Key. Stockez-le dans votre gestionnaire de secrets, pas dans le code source ou dans une application côté client.
Définissez la base URL sur https://api.7loc.com/cards-api et ajoutez Authorization: Bearer suivi de la clé à chaque requête côté serveur.
Appelez d'abord le GET /templates. Une réponse réussie confirme le jeton et affiche les modèles disponibles pour ce lieu de travail/profile.
Choisissez le stable External ID et facultatif External Source depuis votre propre système. Utilisez exactement la même paire d’identités dans la logique de création, d’analyse, de recherche et de webhook.
Appelez le POST /cards/invite avec un contact test jetable. Vérifiez l'installation renvoyée URL avant d'automatiser la livraison aux vrais clients.
Ajoutez POST /cards/scan, un bon ou des actions de message uniquement après avoir effectué la journalisation, la gestion des erreurs et une stratégie de nouvelle tentative/idempotency sécurisée dans votre propre backend.
La référence publique Swagger/OpenAPI contient les schémas actuels de point de terminaison, de paramètre, de corps de requête, de réponse et de webhook. Le URL interactif est https://api.7loc.com/cards-api/docs et le contrat lisible par machine est https://api.7loc.com/cards-api/openapi.json. Lisez-le avant d'implémenter la gestion des erreurs ou d'ajouter des champs facultatifs.
La clé est un secret côté serveur. Ne l'exposez pas dans le JavaScript du navigateur, dans un ensemble d'applications mobiles, dans un formulaire public, dans des captures d'écran, dans des champs de texte Make/Zapier ou dans des tickets d'assistance. Utilisez un serveur, une connexion d'automatisation sécurisée ou un gestionnaire de secrets. Si la clé est partagée accidentellement, révoquez-la ou faites-la pivoter dans 7stamp Admin et mettez à jour la connexion concernée.
Dans 7stamp Admin, rendez-vous sur API Integrations → API Keys → Add API Key. Le jeton est ensuite envoyé dans l'en-tête Authorization sous la forme Bearer suivi de la clé.
Utilisez https://api.7loc.com/cards-api et envoyez Authorization: Bearer YOUR_7STAMP_API_KEY à chaque demande autorisée.
Uniquement lorsque le profil connecté possède exactement un modèle de carte actif. Si plusieurs modèles sont actifs, sélectionnez le bon template_id parmi GET /templates.
Utilisez le API pour un POS personnalisé, un backend, un site ou un contrôle total. Utilisez Make pour les scénarios de branchement visuel. Utilisez Zapier pour un flux de travail d'action de déclenchement principalement linéaire. Tous les trois s'appuient sur la même clé API et le même contrat API.
Pages associées
Étape suivante
Créez la clé, appelez le GET /templates, créez une invitation pour un contact jetable, puis ajoutez les secrets de production, la journalisation, les tentatives et la gestion des webhooks autour de la demande prouvée.