Integrazione con gli sviluppatori
7stamp Integration API consente a CRM, piattaforma di e-commerce, POS, backend personalizzato o strumento di automazione di gestire il portafoglio carte fedeltà con l'identificativo di contatto già utilizzato dal tuo sistema. È l'opzione universale quando non esiste un'integrazione specializzata.
La base API URL è https://api.7loc.com/cards-api. Autentica ogni richiesta con una chiave API come token Bearer. Utilizzare il riferimento OpenAPI collegato per gli schemi di richiesta e risposta in tempo reale prima di creare la logica di produzione.
Il API è il lato di scrittura dello stack di integrazione. Usalo ogni volta che il tuo software deve rimanere la fonte operativa della verità mentre 7stamp gestisce il livello di fidelizzazione del portafoglio.
Genera un collegamento alla carta portafoglio personale per qualsiasi cliente nel tuo sistema. Consegnalo tramite la tua email, SMS, push o flusso in-app. Il cliente apre il collegamento e salva la carta su Apple Wallet o Google Wallet.
Quando un acquisto si chiude nel tuo POS, quando un ordine online viene pagato sul tuo sito web o quando un servizio viene completato nel tuo sistema di prenotazione, chiama il API per accreditare i timbri. La scheda si aggiorna in pochi secondi.
Emetti un voucher una tantum per un cliente specifico, crea flussi di ricompensa pronti per la campagna e ripristina lo stato del voucher nei sistemi che gestiscono la finanza e la qualità del servizio.
Queste sono le rotte pubbliche API dietro Azioni Make e Zapier. Leggi lo schema esatto nel riferimento API; non dedurre i nomi dei campi da un endpoint diverso.
POST /cards/invite Crea una nuova installazione personale URL per un contatto esterno.
POST /cards/invite/bulk Crea fino a 100 collegamenti di invito in un batch controllato.
GET /cards Cerca i record delle carte in base all'identificatore del contatto esterno.
GET /cards/{user_card_id} Restituisce lo stato completo di una carta tramite il suo interno 7stamp ID.
POST /cards/scan Aggiunge francobolli per carta ID o External ID e registra l'ordine di origine quando fornito.
GET /templates Elenca i modelli di carte disponibili per l'ufficio della chiave/profile.
GET /templates/{template_id}/design Legge le impostazioni visive per un modello di carta noto.
POST /vouchers/issue Emette un voucher al titolare della carta.
POST /messages/send Invia il push della carta portafoglio e il contenuto e-mail/or al proprietario della carta.
Queste sono schermate 7stamp Admin reali. Apri API e Integrazioni, aggiungi una chiave, quindi copiala in una connessione segreta o di automazione sicura lato server. Schermata
Crea la chiave in 7stamp Admin sotto API Integrations → API Keys → Add API Key. Una chiave appartiene a un posto di lavoro/profile, quindi crea chiavi separate per lo sviluppo e la produzione quando la configurazione del tuo account lo consente. Ruota o revoca l'accesso dalla dashboard se viene esposto un segreto.
External ID è l'identificatore di contatto stabile del tuo sistema: un CRM ID, cliente UUID, numero di telefono o e-mail. Preferisci un sistema immutabile ID. Facoltativamente aggiungere External Source per evitare collisioni tra sistemi e per rendere esplicita la correlazione del webhook.
Quando il profilo ha un modello attivo, template_id può essere omesso e 7stamp lo seleziona automaticamente. Quando ha più modelli attivi, passa il template_id previsto. Leggi prima GET /templates invece di codificare un ID indovinato.
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
}'Accedi a 7stamp Admin e crea una chiave: API Integrations → API Keys → Add API Key. Memorizzalo nel tuo gestore segreto, non nel codice sorgente o in un'applicazione lato client.
Imposta la base URL su https://api.7loc.com/cards-api e aggiungi Authorization: Bearer seguito dalla chiave per ogni richiesta lato server.
Chiama prima il GET /templates. Una risposta positiva conferma il token e mostra i modelli disponibili per quel posto di lavoro/profile.
Scegli il stabile External ID e l'opzionale External Source dal tuo sistema. Utilizza la stessa identica coppia di identità nella logica di creazione, scansione, ricerca e webhook.
Chiama il POST /cards/invite con un contatto di prova usa e getta. Verifica l'installazione restituita URL prima di automatizzare la consegna ai clienti reali.
Aggiungi POST /cards/scan, voucher o azioni di messaggio solo dopo aver effettuato la registrazione, la gestione degli errori e una strategia di ripetizione sicura/idempotency nel tuo backend.
Il riferimento pubblico Swagger/OpenAPI contiene gli schemi attuali di endpoint, parametro, corpo della richiesta, risposta e webhook. Il URL interattivo è https://api.7loc.com/cards-api/docs e il contratto leggibile dalla macchina è https://api.7loc.com/cards-api/openapi.json. Leggilo prima di implementare la gestione degli errori o aggiungere campi opzionali.
La chiave è un segreto lato server. Non esporlo nel JavaScript del browser, in un bundle di app mobili, in un modulo pubblico, in screenshot, campi di testo Make/Zapier o ticket di supporto. Utilizza un server, una connessione di automazione sicura o un gestore segreto. Se la chiave viene condivisa accidentalmente, revocala o ruotala in 7stamp Admin e aggiorna la connessione interessata.
In 7stamp Admin, vai a API Integrations → API Keys → Add API Key. Il token viene quindi inviato nell'intestazione Authorization come Bearer seguito dalla chiave.
Usa https://api.7loc.com/cards-api e invia Authorization: Bearer YOUR_7STAMP_API_KEY su ogni richiesta autorizzata.
Solo quando il profilo connesso ha esattamente un modello di tessera attivo. Se sono attivi più modelli, seleziona il template_id corretto da GET /templates.
Utilizza API per un POS personalizzato, un backend, un sito o un controllo completo. Utilizzare Make per scenari di ramificazione visiva. Utilizzare Zapier per un flusso di lavoro con azione trigger prevalentemente lineare. Tutti e tre si basano sulla stessa chiave API e sul contratto API.
Pagine correlate
Passaggio successivo
Crea la chiave, chiama GET /templates, crea un invito per un contatto usa e getta, quindi aggiungi segreti di produzione, registrazione, tentativi e gestione del webhook attorno alla richiesta comprovata.