Integratie van ontwikkelaars
Met 7stamp Integration API kan een CRM, e-commerceplatform, POS, aangepaste backend of automatiseringstool de portemonnee beheren klantenkaarten met de contactidentificatie die uw eigen systeem al gebruikt. Het is de universele optie als er geen gespecialiseerde integratie bestaat.
De API basis URL is https://api.7loc.com/cards-api. Authenticeer elk verzoek met een API sleutel als een Bearer token. Gebruik de gekoppelde OpenAPI referentie voor de live aanvraag- en antwoordschema's voordat u productielogica gaat bouwen.
De API is de schrijfzijde van de integratiestack. Gebruik het wanneer uw eigen software de operationele bron van waarheid moet blijven, terwijl 7stamp de portemonnee-loyaliteitslaag afhandelt.
Genereer een persoonlijke portemonneekaartlink voor elke klant in uw systeem. Bezorg het via uw eigen e-mail, SMS, push of in-app-flow. De klant opent de link en slaat de kaart op in Apple Wallet of Google Wallet.
Wanneer een aankoop in uw aangepaste POS wordt gesloten, wanneer een online bestelling op uw website wordt betaald of wanneer een dienst in uw boekingssysteem is voltooid, belt u API voor kredietstempels. De kaart wordt binnen enkele seconden bijgewerkt.
Geef een eenmalige voucher uit aan een specifieke klant, creëer campagneklare beloningsstromen en haal de voucherstatus terug naar de systemen die de financiële en servicekwaliteit beheren.
Dit zijn de openbare API routes achter de Make en Zapier acties. Lees het exacte schema in de referentie API; leid veldnamen niet af van een ander eindpunt.
POST /cards/invite Creëert een nieuwe persoonlijke installatie URL voor een extern contact.
POST /cards/invite/bulk Creëert maximaal 100 uitnodigingslinks in een gecontroleerde batch.
GET /cards Kaartrecords opzoeken op basis van externe contact-ID.
GET /cards/{user_card_id} Retourneert de volledige status van één kaart via de interne 7stamp ID.
POST /cards/scan Voegt stempels toe per kaart ID of External ID en registreert de bronvolgorde wanneer deze wordt aangeleverd.
GET /templates Lijst met kaartsjablonen die beschikbaar zijn voor de werkplek van de sleutel/profile.
GET /templates/{template_id}/design Leest visuele instellingen voor een bekende kaartsjabloon.
POST /vouchers/issue Geeft een voucher uit aan een kaarteigenaar.
POST /messages/send Stuurt portemonnee-kaartpush en/or e-mailinhoud naar een kaarteigenaar.
Dit zijn echte 7stamp Admin-schermen. Open API & Integraties, voeg een sleutel toe en kopieer deze vervolgens naar een beveiligd servergeheim of een automatiseringsverbinding.
Maak de sleutel in 7stamp Admin onder API Integrations → API Keys → Add API Key. Een sleutel hoort bij één werkplek/profile, dus maak aparte sleutels voor ontwikkeling en productie als uw accountconfiguratie dit toestaat. Roteer of trek de toegang vanaf het dashboard in als er een geheim openbaar wordt gemaakt.
External ID is de stabiele contact-ID van uw systeem: een CRM ID, klant UUID, telefoonnummer of e-mailadres. Geef de voorkeur aan een onveranderlijk systeem ID. Voeg optioneel External Source toe om botsingen tussen systemen te voorkomen en om webhookcorrelatie expliciet te maken.
Wanneer het profiel één actieve sjabloon heeft, kan template_id worden weggelaten en wordt deze door 7stamp automatisch geselecteerd. Als er meerdere actieve sjablonen zijn, geef dan de bedoelde template_id door. Lees eerst GET /templates in plaats van een geraden ID hard te coderen.
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
}'Log in op 7stamp Admin en maak een sleutel aan: API Integrations → API Keys → Add API Key. Bewaar het in uw geheime manager, niet in de broncode of in een client-side applicatie.
Stel de basis URL in op https://api.7loc.com/cards-api en voeg Authorization toe: Bearer gevolgd door de sleutel voor elk serververzoek.
Bel eerst GET /templates. Een succesvol antwoord bevestigt het token en toont de beschikbare sjablonen voor die werkplek/profile.
Kies de stabiele External ID en optionele External Source uit uw eigen systeem. Gebruik exact hetzelfde identiteitspaar in de logica voor maken, scannen, opzoeken en webhook.
Bel POST /cards/invite met een wegwerptestcontact. Controleer de geretourneerde installatie URL voordat u de levering aan echte klanten automatiseert.
Voeg alleen POST /cards/scan, voucher- of berichtacties toe nadat u in uw eigen backend over logboekregistratie, foutafhandeling en een veilige strategie voor opnieuw proberen/idempotency beschikt.
De openbare verwijzing Swagger/OpenAPI bevat de huidige eindpunt-, parameter-, verzoektekst-, respons- en webhook-schema's. Het interactieve URL is https://api.7loc.com/cards-api/docs en het machinaal leesbare contract is https://api.7loc.com/cards-api/openapi.json. Lees het voordat u foutafhandeling implementeert of optionele velden toevoegt.
De sleutel is een geheim op de server. Stel het niet bloot in browser-JavaScript, een mobiele app-bundel, een openbaar formulier, screenshots, Make/Zapier tekstvelden of ondersteuningstickets. Gebruik een server, een beveiligde automatiseringsverbinding of een geheime manager. Als de sleutel ooit per ongeluk wordt gedeeld, trekt u deze in of roteert u deze in 7stamp Admin en werkt u de betreffende verbinding bij.
Ga in 7stamp Admin naar API Integrations → API Keys → Add API Key. Het token wordt vervolgens in de header Authorization verzonden als Bearer, gevolgd door de sleutel.
Gebruik https://api.7loc.com/cards-api en verzend Authorization: Bearer YOUR_7STAMP_API_KEY voor elk geautoriseerd verzoek.
Alleen als het verbonden profiel precies één actief kaartsjabloon heeft. Als er meerdere sjablonen actief zijn, selecteert u de juiste template_id uit GET /templates.
Gebruik API voor een aangepaste POS, backend, site of volledig beheer. Gebruik Make voor visuele vertakkingsscenario's. Gebruik Zapier voor een overwegend lineaire trigger-actieworkflow. Alle drie vertrouwen op dezelfde API sleutel en API contract.
Gerelateerde pagina's
Volgende stap
Maak de sleutel aan, bel GET /templates, maak één uitnodiging voor een wegwerpcontact en voeg vervolgens productiegeheimen, logboekregistratie, nieuwe pogingen en webhook-afhandeling rond het bewezen verzoek toe.