Utsted kort fra din egen programvare
Generer en personlig lommebokkortkobling for enhver kunde i systemet ditt. Lever den via din egen e-post, SMS, push eller flyt i appen. Kunden åpner lenken og lagrer kortet til Apple Wallet eller Google Wallet.
Utviklerintegrasjon
7stamp REST API
Tilgjengelig7stamp Integration API lar en CRM, e-handelsplattform, POS, tilpasset backend eller automatiseringsverktøy administrere lommeboklojalitetskort med kontaktidentifikatoren ditt eget system allerede bruker. Det er det universelle alternativet når en spesialisert integrasjon ikke eksisterer.
API-basen URL er https://api.7loc.com/cards-api. Autentiser hver forespørsel med en API-nøkkel som et Bearer-token. Bruk den koblede OpenAPI-referansen for live-forespørsels- og svarskjemaene før du bygger produksjonslogikk.
Hva du kan gjøre med API
API er skrivesiden av integrasjonsstakken. Bruk den når din egen programvare skal være den operasjonelle kilden til sannhet mens 7stamp håndterer lojalitetslaget i lommeboken.
Kredittstempler fra en hvilken som helst kilde
Når et kjøp avsluttes i din egendefinerte POS, når en online bestilling betales på nettstedet ditt, eller når en tjeneste er fullført i bestillingssystemet ditt, ring API til kredittstempler. Kortet oppdateres i løpet av sekunder.
Administrer kuponger og kampanjer
Utsted en engangskupong til en spesifikk kunde, lag kampanjeklare belønningsflyter og trekk kupongstatus tilbake til systemene som håndterer økonomi og servicekvalitet.
Dokumentert integrasjon API operasjoner
These are the public API routes behind the Make and Zapier actions. Read the exact schema in the API reference; do not infer field names from a different endpoint.
Kort
POST /cards/invite Lag en kortinvitasjon
Oppretter en fersk personlig installasjon URL for en ekstern kontakt.
Kort
POST /cards/invite/bulk Masseopprett kortinvitasjoner
Oppretter opptil 100 invitasjonslenker i en kontrollert batch.
Kort
GET /cards Finn kort
Slår opp kortposter ved hjelp av ekstern kontaktidentifikator.
Kort
GET /cards/{user_card_id} Få kortdetaljer
Returnerer hele tilstanden til ett kort ved dets interne 7stamp ID.
Kort
POST /cards/scan Skann et kort
Legger til stempler med kort ID eller External ID og registrerer kilderekkefølgen når den leveres.
Maler
GET /templates Liste maler
Viser kortmaler som er tilgjengelige for nøkkelens arbeidsplass/profile.
Maler
GET /templates/{template_id}/design Få maldesign
Leser visuelle innstillinger for en kjent kortmal.
Bilag
POST /vouchers/issue Utsted en kupong
Utsteder en kupong til en korteier.
Meldinger
POST /messages/send Send en melding
Sender lommebokkort-push og/or e-postinnhold til en korteier.
Hvor skal du opprette og kopiere API-tasten
Dette er ekte 7stamp Admin-skjermer. Åpne API & Integrations, legg til en nøkkel, og kopier den deretter til en sikker serversidehemmelighet eller automatiseringstilkobling.
Tre avgjørelser å ta før koding
API nøkkelomfang
Opprett nøkkelen i 7stamp Admin under API Integrations → API Keys → Add API Key. En nøkkel tilhører én arbeidsplass/profile, så lag separate nøkler for utvikling og produksjon når kontooppsettet tillater det. Roter eller tilbakekall tilgang fra dashbordet hvis en hemmelighet avsløres.
Kundeidentitet
External ID er den stabile kontaktidentifikatoren fra systemet ditt: en CRM ID, kunde UUID, telefonnummer eller e-post. Foretrekk et uforanderlig system ID. Legg eventuelt til External Source for å unngå kollisjoner på tvers av systemer og for å gjøre webhook-korrelasjon eksplisitt.
Malvalg
Når profilen har én aktiv mal, kan template_id utelates og 7stamp velger den automatisk. Når den har flere aktive maler, send den tiltenkte template_id. Les GET /templates først i stedet for å hardkode en gjettet ID.
Minimal autentisert forespørsel: opprett en invitasjon
Kopier dette inn i automatiseringstrinnet
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
}'Fra API nøkkel til en første vellykket forespørsel
Sign in to 7stamp Admin and create a key: API Integrations → API Keys → Add API Key. Store it in your secret manager, not source code or a client-side application.
Sett basen URL til https://api.7loc.com/cards-api og legg til Authorization: Bearer etterfulgt av nøkkelen til hver serversideforespørsel.
Ring først GET /templates. Et vellykket svar bekrefter tokenet og viser malene som er tilgjengelige for den arbeidsplassen/profile.
Velg den stabile External ID og valgfri External Source fra ditt eget system. Bruk nøyaktig samme identitetspar i logikk for opprettelse, skanning, oppslag og webhook.
Ring POST /cards/invite med en engangstestkontakt. Bekreft den returnerte installasjonen URL før du automatiserer levering til ekte kunder.
Legg til POST /cards/scan, kupong- eller meldingshandlinger bare etter at du har logging, feilhåndtering og en sikker strategi på nytt/idempotency i din egen backend.
Bruk API-referansen som kontrakt
Den offentlige Swagger/OpenAPI-referansen inneholder gjeldende endepunkt, parameter, forespørselstekst, svar og webhook-skjemaer. Den interaktive URL er https://api.7loc.com/cards-api/docs og den maskinlesbare kontrakten er https://api.7loc.com/cards-api/openapi.json. Les den før du implementerer feilhåndtering eller legger til valgfrie felt.
Autentisering og nøkkelsikkerhet
Nøkkelen er en hemmelighet på serversiden. Ikke vis den i nettleserens JavaScript, en mobilappsamling, et offentlig skjema, skjermbilder, Make/Zapier tekstfelt eller støttebilletter. Bruk en server, sikker automatiseringstilkobling eller hemmelig manager. Hvis nøkkelen noen gang deles ved et uhell, tilbakekall eller roter den i 7stamp Admin og oppdater den berørte tilkoblingen.
Vanlige spørsmål
Hvor får jeg et 7stamp API-token?
I 7stamp Admin, gå til API Integrations → API Keys → Add API Key. Tokenet sendes deretter i Authorization-overskriften som Bearer etterfulgt av nøkkelen.
Hva er basis URL og autentiseringsmetode?
Bruk https://api.7loc.com/cards-api og send Authorization: Bearer YOUR_7STAMP_API_KEY på hver autorisert forespørsel.
Når kan jeg utelate template_id?
Bare når den tilkoblede profilen har nøyaktig én aktiv kortmal. Hvis flere maler er aktive, velg riktig template_id fra GET /templates.
Skal jeg bruke API, Make2 eller 37?
Bruk API for en tilpasset POS, backend, nettsted eller full kontroll. Bruk Make for visuelle forgreningsscenarier. Bruk Zapier for en hovedsakelig lineær trigger-action arbeidsflyt. Alle tre er avhengige av samme API-nøkkel og API-kontrakt.
Relaterte sider
Neste trinn
Test den minste sikre API flyt først
Opprett nøkkelen, ring GET /templates, lag én invitasjon for en engangskontakt, legg deretter til produksjonshemmeligheter, logging, forsøk på nytt og webhook-håndtering rundt den påviste forespørselen.