Integrarea dezvoltatorului
7stamp Integration API permite unui CRM, platformă de comerț electronic, POS, backend personalizat sau instrument de automatizare să gestioneze cardurile de fidelitate portofel cu identificatorul de contact pe care sistemul dvs. îl folosește deja. Este varianta universală atunci când nu există o integrare specializată.
Baza API URL este https://api.7loc.com/cards-api. Autentificați fiecare solicitare cu o cheie API ca simbol Bearer. Utilizați referința legată OpenAPI pentru cererile live și schemele de răspuns înainte de a construi logica de producție.
API este partea de scriere a stivei de integrare. Folosește-l ori de câte ori propriul tău software ar trebui să rămână sursa operațională a adevărului, în timp ce 7stamp se ocupă de nivelul de loialitate al portofelului.
Generați un link pentru cardul de portofel personal pentru orice client din sistemul dvs. Trimiteți-l prin e-mail propriu, SMS, push sau flux în aplicație. Clientul deschide linkul și salvează cardul în Apple Wallet sau Google Wallet.
Când se închide o achiziție în POS personalizat, când o comandă online este plătită pe site-ul dvs. sau când un serviciu este finalizat în sistemul dvs. de rezervare, sunați la API pentru timbre de credit. Cardul se actualizează în câteva secunde.
Emiteți un voucher unic unui anumit client, creați fluxuri de recompense pregătite pentru campanie și retrageți starea voucherului în sistemele care gestionează finanțarea și calitatea serviciilor.
Acestea sunt rutele publice API din spatele acțiunilor Make și Zapier. Citiți schema exactă în referința API; nu deduceți numele câmpurilor de la un punct final diferit.
POST /cards/invite Creează o nouă instalare personală URL pentru un contact extern.
POST /cards/invite/bulk Creează până la 100 de link-uri de invitație într-un lot controlat.
GET /cards Caută înregistrările cardului după identificatorul de contact extern.
GET /cards/{user_card_id} Returnează starea completă a unui card prin 7stamp ID intern.
POST /cards/scan Adaugă ștampile prin card ID sau External ID și înregistrează comanda sursă atunci când este furnizată.
GET /templates Listează șabloanele de carduri disponibile la locul de muncă al cheii/profile.
GET /templates/{template_id}/design Citește setările vizuale pentru un șablon de card cunoscut.
POST /vouchers/issue Emite un voucher unui proprietar de card.
POST /messages/send Trimite conținut push-carte de portofel și/or e-mail către proprietarul cardului.
Acestea sunt ecrane reale 7stamp Admin. Deschideți API și integrări, adăugați o cheie, apoi copiați-o într-o conexiune de automatizare sau secretă pe server.
Creați cheia în 7stamp Admin sub API Integrations → API Keys → Add API Key. O cheie aparține unui singur loc de muncă/profile, așa că creați chei separate pentru dezvoltare și producție atunci când configurarea contului o permite. Rotiți sau revocați accesul din tabloul de bord dacă este expus un secret.
External ID este identificatorul stabil de contact din sistemul dvs.: a CRM ID, client UUID, sau e-mail, număr de telefon. Prefer un sistem imuabil ID. Adăugați opțional External Source pentru a evita coliziunile între sisteme și pentru a face explicită corelația webhook.
Când profilul are un șablon activ, template_id poate fi omis și 7stamp îl selectează automat. Când are mai multe șabloane active, treceți template_id. Citiți mai întâi GET /templates în loc să codificați tare un ID ghicit.
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
}'Conectați-vă la 7stamp Admin și creați o cheie: API Integrations → API Keys → Add API Key191. Stocați-l în managerul dvs. secret, nu în codul sursă sau într-o aplicație pe partea clientului.
Setați baza URL la https://api.7loc.com/cards-api și adăugați Authorization: Bearer urmat de cheia fiecărei cereri de pe partea serverului.
Sună mai întâi la GET /templates. Un răspuns de succes confirmă simbolul și arată șabloanele disponibile pentru acel loc de muncă/profile.
Alegeți stabilul External ID și opțional External Source din propriul sistem. Utilizați exact aceeași pereche de identitate în logica de creare, scanare, căutare și webhook.
Sunați la POST /cards/invite cu un contact de testare de unică folosință. Verificați instalarea returnată URL înainte de a automatiza livrarea către clienți reali.
Adăugați POST /cards/scan, voucher sau acțiuni de mesaje numai după ce aveți o strategie de logare, de gestionare a erorilor și o reîncercare sigură/idempotency în propriul backend.
Referința publică Swagger/OpenAPI conține punctul final curent, parametrul, corpul cererii, răspunsul și schemele webhook. URL interactiv este https://api.7loc.com/cards-api/docs și contractul care poate fi citit de mașină este https://api.7loc.com/cards-api/openapi.json. Citiți-l înainte de a implementa gestionarea erorilor sau de a adăuga câmpuri opționale.
Cheia este un secret pe partea serverului. Nu-l expuneți în JavaScript de browser, într-un pachet de aplicații mobile, într-un formular public, în capturi de ecran, în câmpurile de text Make/Zapier sau în bilete de asistență. Utilizați un server, o conexiune de automatizare securizată sau un manager secret. Dacă cheia este partajată accidental, revocați-o sau rotiți-o în 7stamp Admin și actualizați conexiunea afectată.
În 7stamp Admin, accesați API Integrations → API Keys → Add API Key. Jetonul este apoi trimis în antetul Authorization ca Bearer urmat de cheie.
Folosiți https://api.7loc.com/cards-api și trimiteți Authorization: Bearer YOUR_7STAMP_API_KEY la fiecare cerere autorizată.
Numai când profilul conectat are exact un șablon de card activ. Dacă sunt active mai multe șabloane, selectați template_id corect din GET /templates.
Utilizați API pentru un POS, backend, site sau control deplin personalizat. Utilizați Make pentru scenarii de ramificare vizuală. Utilizați Zapier pentru un flux de lucru cu acțiune de declanșare în mare parte liniară. Toți trei se bazează pe aceeași cheie API și pe același contract API.
Pagini înrudite
Următorul pas
Creați cheia, sunați la GET /templates, creați o invitație pentru un contact de unică folosință, apoi adăugați secrete de producție, înregistrare, reîncercări și gestionarea webhook în jurul cererii dovedite.