Integració de desenvolupadors
El 7stamp Integration API permet a un CRM, una plataforma de comerç electrònic, un POS, un backend personalitzat o una eina d'automatització gestionar les targetes de fidelització de cartera amb l'identificador de contacte que ja utilitza el vostre propi sistema. És l'opció universal quan no existeix una integració especialitzada.
La base API URL és https://api.7loc.com/cards-api. Autentiqueu cada sol·licitud amb una clau API com a testimoni Bearer. Utilitzeu la referència OpenAPI enllaçada per als esquemes de sol·licitud i resposta en directe abans de crear la lògica de producció.
El API és el costat d'escriptura de la pila d'integració. Utilitzeu-lo sempre que el vostre propi programari sigui la font operativa de la veritat mentre 7stamp gestiona la capa de lleialtat de la cartera.
Genereu un enllaç de targeta de cartera personal per a qualsevol client del vostre sistema. Envieu-lo mitjançant el vostre propi correu electrònic, SMS, push o flux dins de l'aplicació. El client obre l'enllaç i desa la targeta a Apple Wallet o Google Wallet.
Quan es tanqui una compra al vostre POS personalitzat, quan es pagui una comanda en línia al vostre lloc web o quan es completi un servei al vostre sistema de reserves, truqueu al API per acreditar els segells. La targeta s'actualitza en qüestió de segons.
Emeteu un val únic a un client específic, creeu fluxos de recompenses preparats per a la campanya i torneu a incorporar l'estat del val als sistemes que gestionen les finances i la qualitat del servei.
Aquestes són les 65 rutes públiques1⟧ Accions Make i Zapier. Llegeix l'esquema exacte a la referència API; no inferiu noms de camps d'un punt final diferent.
POST /cards/invite Crea una instal·lació personal nova URL per a un contacte extern.
POST /cards/invite/bulk Crea fins a 100 enllaços d'invitació en un lot controlat.
GET /cards Cerca els registres de les targetes per identificador de contacte extern.
GET /cards/{user_card_id} Retorna l'estat complet d'una targeta per la seva 7stamp ID interna.
POST /cards/scan Afegeix segells amb targeta ID o External ID i registra l'ordre d'origen quan es subministra.
GET /templates Llista les plantilles de targetes disponibles al lloc de treball de la clau/profile.
GET /templates/{template_id}/design Llegeix la configuració visual d'una plantilla de targeta coneguda.
POST /vouchers/issue Emet un val al propietari d'una targeta.
POST /messages/send Envia contingut push de la targeta de cartera i/or correu electrònic al propietari d'una targeta.
Aquestes són pantalles 7stamp Admin reals. Obriu API i integracions, afegiu una clau i, a continuació, copieu-la a un secret segur del costat del servidor o a una connexió d'automatització. Pantalla
Creeu la clau a 7stamp Admin a API Integrations → API Keys → Add API Key. Una clau pertany a un lloc de treball/profile, així que creeu claus separades per al desenvolupament i la producció quan la configuració del vostre compte ho permeti. Gireu o revoqueu l'accés des del tauler si s'exposa un secret.
External ID és l'identificador de contacte estable del vostre sistema: un CRM ID, client UUID, número de telèfon o correu electrònic. Preferiu un sistema immutable ID. Opcionalment, afegiu External Source per evitar col·lisions entre sistemes i per fer explícita la correlació de webhook.
Quan el perfil té una plantilla activa, template_id es pot ometre i 7stamp la selecciona automàticament. Quan tingui diverses plantilles actives, passeu el template_id previst. Llegiu primer GET /templates en lloc de codificar un ID endevinat.
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
}'Inicieu la sessió a 7stamp Admin i creeu una clau: ⟦6675. Emmagatzemeu-lo al vostre gestor secret, no al codi font ni a una aplicació del costat del client.
Estableix la base URL a https://api.7loc.com/cards-api i afegiu Authorization: Bearer seguit de la clau a cada sol·licitud del servidor.
Truqueu primer al GET /templates. Una resposta correcta confirma el testimoni i mostra les plantilles disponibles per a aquest lloc de treball/profile.
Trieu l'estable External ID i l'opcional External Source del vostre propi sistema. Utilitzeu exactament el mateix parell d'identitats a la lògica de creació, exploració, cerca i webhook.
Truqueu al POST /cards/invite amb un contacte de prova d'un sol ús. Verifiqueu la instal·lació retornada URL abans d'automatitzar el lliurament als clients reals.
Afegiu POST /cards/scan, un val o accions de missatge només després de tenir una estratègia de registre, gestió d'errors i un nou intent/idempotency segur al vostre propi backend.
La referència pública Swagger/OpenAPI conté els esquemes actuals del punt final, el paràmetre, el cos de la sol·licitud, la resposta i el webhook. El URL interactiu és https://api.7loc.com/cards-api/docs i el contracte llegible per màquina és https://api.7loc.com/cards-api/openapi.json. Llegiu-lo abans d'implementar la gestió d'errors o afegir camps opcionals.
La clau és un secret del servidor. No l'exposeu en JavaScript del navegador, en un paquet d'aplicacions mòbils, en un formulari públic, en captures de pantalla, en camps de text Make/Zapier o en bitllets d'assistència. Utilitzeu un servidor, una connexió d'automatització segura o un gestor secret. Si alguna vegada la clau es comparteix accidentalment, revoqueu-la o gireu-la a 7stamp Admin i actualitzeu la connexió afectada.
A 7stamp Admin, aneu a API Integrations → API Keys → Add API Key. A continuació, el testimoni s'envia a la capçalera Authorization com a Bearer seguit de la clau.
Utilitzeu https://api.7loc.com/cards-api i envieu Authorization: Bearer YOUR_7STAMP_API_KEY a cada sol·licitud autoritzada.
Només quan el perfil connectat tingui exactament una plantilla de targeta activa. Si hi ha diverses plantilles actives, seleccioneu la template_id correcta de GET /templates.
Utilitzeu el API per a un POS, un backend, un lloc personalitzat o un control total. Utilitzeu Make per a escenaris de ramificació visual. Utilitzeu Zapier per a un flux de treball d'acció d'activació principalment lineal. Tots tres es basen en la mateixa clau API i en el mateix contracte API.
Pàgines relacionades
Següent pas
Creeu la clau, truqueu al GET /templates, creeu una invitació per a un contacte d'un sol ús i, a continuació, afegiu secrets de producció, registres, reintents i gestió de webhook al voltant de la sol·licitud provada.