Integrering av utvecklare

7stamp REST API

Tillgänglig

7stamp Integration API låter en CRM, e-handelsplattform, POS, anpassad backend eller automatiseringsverktyg hantera plånbokslojalitetskort med kontaktidentifieraren som ditt eget system redan använder. Det är det universella alternativet när en specialiserad integration inte existerar.

API-basen URL är https://api.7loc.com/cards-api. Autentisera varje begäran med en API-nyckel som en Bearer-token. Använd den länkade OpenAPI-referensen för livebegäran och svarsscheman innan du bygger produktionslogik.

Öppna API referens Öppet OpenAPI JSON

Vad du kan göra med API

API är skrivsidan av integrationsstacken. Använd den närhelst din egen programvara ska förbli den operativa källan till sanning medan 7stamp hanterar lojalitetslagret i plånboken.

Ge ut kort från din egen programvara

Skapa en personlig plånbokslänk för alla kunder i ditt system. Leverera den via din egen e-post, SMS, push eller flöde i appen. Kunden öppnar länken och sparar kortet till Apple Wallet eller Google Wallet.

Kreditstämplar från valfri källa

När ett köp avslutas i din anpassade POS, när en onlinebeställning betalas på din webbplats, eller när en tjänst har slutförts i ditt bokningssystem, ring API till kreditstämplar. Kortet uppdateras inom några sekunder.

Hantera kuponger och kampanjer

Ge ut en engångskupong till en specifik kund, skapa kampanjfärdiga belöningsflöden och dra kupongstatus tillbaka till systemen som hanterar ekonomi och servicekvalitet.

Dokumenterad integration API operationer

Dessa är den offentliga vägen ⟦99999903 åtgärderna Make och Zapier. Läs det exakta schemat i referensen API; härled inte fältnamn från en annan slutpunkt.

Kort POST /cards/invite

Skapa en kortinbjudan

Skapar en ny personlig installation URL för en extern kontakt.

Kort POST /cards/invite/bulk

Skapa kortinbjudningar i bulk

Skapar upp till 100 inbjudningslänkar i en kontrollerad batch.

Kort GET /cards

Hitta kort

Söker upp kortposter med hjälp av extern kontaktidentifierare.

Kort GET /cards/{user_card_id}

Få kortdetaljer

Returnerar det fullständiga tillståndet för ett kort genom dess interna 7stamp ID.

Kort POST /cards/scan

Skanna ett kort

Lägger till stämplar med kort ID eller External ID och registrerar källordningen när den levereras.

Mallar GET /templates

Lista mallar

Listar kortmallar som är tillgängliga för nyckelns arbetsplats/profile.

Mallar GET /templates/{template_id}/design

Få malldesign

Läser visuella inställningar för en känd kortmall.

Verifikationer POST /vouchers/issue

Utfärda en kupong

Utfärdar en kupong till en kortägare.

Meddelanden POST /messages/send

Skicka ett meddelande

Skickar plånbokskort-push och/or e-postinnehåll till en kortägare.

Var man skapar och kopierar API-nyckeln

Dessa är riktiga 7stamp Admin-skärmar. Öppna API & Integrations, lägg till en nyckel och kopiera den sedan till en säker serversidahemlighet eller automatiseringsanslutning.

7stamp Admin API & Integreringsskärm som visar knappen Add API Key och Generera API Nyckeldialogruta
Steg 1 — Välj & 53 ⟧ i navigeringen till vänster API Keys, välj Add API Key, välj lämplig personalinloggning och generera nyckeln.
7stamp Admin dialogruta som visar en nygenererad API-nyckel och dess kopieringskontroll
Steg 2 — Kopiera den nya nyckeln till en lösenordshanterare, hemlighet på serversidan eller säker Make05. Klistra inte in den i källkoden, ett webbläsarprogram eller en supportärende.

Tre beslut att fatta innan kodning

API nyckelomfång

Skapa nyckeln i 7stamp Admin under API Integrations → API Keys → Add API Key. En nyckel tillhör en arbetsplats/profile, så skapa separata nycklar för utveckling och produktion när ditt kontoinställningar tillåter det. Rotera eller återkalla åtkomst från instrumentpanelen om en hemlighet avslöjas.

Kundidentitet

External ID är den stabila kontaktidentifieraren från ditt system: en CRM ID, kund UUID, telefonnummer, e-post. Föredrar ett oföränderligt system ID. Lägg eventuellt till External Source för att undvika kollisioner mellan system och för att göra webhook-korrelation explicit.

Val av mall

När profilen har en aktiv mall kan template_id utelämnas och 7stamp väljer den automatiskt. När den har flera aktiva mallar, skicka den avsedda template_id. Läs GET /templates först istället för att hårdkoda en gissad ID.

Minimal autentiserad begäran: skapa en inbjudan

Kopiera detta till ditt automatiseringssteg 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
  }'

Från API nyckel till en första framgångsrik begäran

01

Logga in på 7stamp Admin och skapa en nyckel: ⟦20. Lagra det i din hemliga hanterare, inte i källkoden eller en applikation på klientsidan.

02

Ställ in basen URL till https://api.7loc.com/cards-api och lägg till Authorization: Bearer följt av nyckeln till varje begäran på serversidan.

03

Ring först GET /templates. Ett framgångsrikt svar bekräftar token och visar mallarna som är tillgängliga för den arbetsplatsen/profile.

04

Välj den stabila External ID och valfria External Source från ditt eget system. Använd exakt samma identitetspar i logiken skapa, skanna, slå upp och webhook.

05

Ring POST /cards/invite med en engångstestkontakt. Verifiera den returnerade installationen URL innan du automatiserar leveransen till riktiga kunder.

06

Lägg till POST /cards/scan, kupong eller meddelandeåtgärder först efter att du har loggning, felhantering och en säker återförsök/idempotency-strategi i din egen backend.

Använd referensen API som kontrakt

Den offentliga Swagger/OpenAPI-referensen innehåller det aktuella schemat för slutpunkt, parameter, begäran-kropp, svar och webhook. Den interaktiva URL är https://api.7loc.com/cards-api/docs och det maskinläsbara kontraktet är https://api.7loc.com/cards-api/openapi.json. Läs det innan du implementerar felhantering eller lägger till valfria fält.

Autentisering och nyckelsäkerhet

Nyckeln är en hemlighet på serversidan. Exponera det inte i webbläsarens JavaScript, ett mobilapp-paket, ett offentligt formulär, skärmdumpar, Make/Zapier textfält eller supportbiljetter. Använd en server, säker automatiseringsanslutning eller hemlig hanterare. Om nyckeln någonsin delas av misstag, återkalla eller rotera den i 7stamp Admin och uppdatera den berörda anslutningen.

Vanliga frågor

Var får jag en 7stamp API token?

I 7stamp Admin, gå till API Integrations → API Keys → Add API Key. Token skickas sedan i rubriken Authorization som Bearer följt av nyckeln.

Vad är basen URL och autentiseringsmetod?

Använd https://api.7loc.com/cards-api och skicka Authorization: Bearer YOUR_7STAMP_API_KEY på varje auktoriserad begäran.

När kan jag utelämna template_id?

Endast när den anslutna profilen har exakt en aktiv kortmall. Om flera mallar är aktiva, välj rätt template_id från GET /templates.

Ska jag använda API, Make200 eller 13⟧0?

Använd API för en anpassad POS, backend, webbplats eller full kontroll. Använd Make för visuella förgreningsscenarier. Använd Zapier för ett mestadels linjärt trigger-action-arbetsflöde. Alla tre förlitar sig på samma API-nyckel och API-kontrakt.

Relaterade sidor

Öppen API referens Öppen OpenAPI JSON Webhook guide 20025 HTTP guide

Nästa steg

Testa det minsta säkra API flödet först

Skapa nyckeln, ring GET /templates, skapa en inbjudan för en engångskontakt, lägg sedan till produktionshemligheter, loggning, försök igen och webhook-hantering kring den beprövade begäran.

Öppen API referens Öppen 7stamp Admin