Fejlesztői integráció
A 7stamp Integration API lehetővé teszi, hogy egy CRM, e-kereskedelmi platform, POS, egyéni háttérrendszer vagy automatizálási eszköz kezelje a pénztárca hűségkártyákat a saját rendszere által már használt kapcsolati azonosítóval. Ez az univerzális lehetőség, ha nem létezik speciális integráció.
Az API alap URL a https://api.7loc.com/cards-api. Hitelesítsen minden kérést egy API kulccsal Bearer tokenként. Használja a hivatkozott OpenAPI hivatkozást az élő kérés- és válaszsémákhoz, mielőtt létrehozná a termelési logikát.
Az API az integrációs verem írási oldala. Használja, amikor a saját szoftvere az igazság működési forrása marad, miközben a 7stamp kezeli a pénztárca hűségrétegét.
Személyes pénztárcakártya hivatkozás létrehozása a rendszerében lévő bármely ügyfél számára. Küldje el saját e-mail-címén, SMS-on, push-on vagy alkalmazáson belüli folyamaton keresztül. Az ügyfél megnyitja a linket, és elmenti a kártyát a Apple Wallet vagy a Google Wallet számra.
Amikor a vásárlás lezárul az Ön egyéni POS számában, ha online rendelést fizetnek ki a webhelyén, vagy amikor egy szolgáltatás befejeződik a foglalási rendszerében, hívja a API számot a jóváírásért. A kártya másodperceken belül frissül.
Egyszeri utalvány kiállítása egy adott ügyfél számára, kampánykész jutalomfolyamatok létrehozása, valamint az utalvány státuszának visszaállítása a pénzügyi és szolgáltatási minőséget kezelő rendszerekbe.
Ezek a nyilvános API útvonalak a Make és Zapier műveletek mögött. Olvassa el a pontos sémát a API hivatkozásban; ne következtessen mezőnevekre egy másik végpontból.
POST /cards/invite Új személyes telepítést hoz létre URL egy külső kapcsolathoz.
POST /cards/invite/bulk Akár 100 meghívó hivatkozást hoz létre egy ellenőrzött kötegben.
GET /cards Megkeresi a kártyarekordokat külső kapcsolati azonosító alapján.
GET /cards/{user_card_id} Egy kártya teljes állapotát adja vissza a belső 7stamp ID szerint.
POST /cards/scan Bélyegzőket ad hozzá a ID vagy External ID kártyával, és rögzíti a forrásrendelést, ha rendelkezésre áll.
GET /templates Felsorolja a kulcs munkahelyén elérhető kártyasablonokat/profile.
GET /templates/{template_id}/design Beolvassa egy ismert kártyasablon vizuális beállításait.
POST /vouchers/issue Utalványt állít ki a kártyatulajdonosnak.
POST /messages/send Wallet-card push és /or e-mail tartalmat küld a kártyatulajdonosnak.
Ezek valódi 7stamp Admin képernyők. Nyissa meg a API & Integrations alkalmazást, adjon hozzá egy kulcsot, majd másolja azt egy biztonságos szerveroldali titkos vagy automatizálási kapcsolatba.
Hozza létre a kulcsot a 7stamp Admin alatt a API Integrations → API Keys → Add API Key alatt. Egy kulcs egy munkahelyhez tartozik/profile, ezért hozzon létre külön kulcsokat a fejlesztéshez és az előállításhoz, amikor a fiókbeállítások lehetővé teszik. Forgassa el vagy vonja vissza a hozzáférést az irányítópulton, ha egy titok kiderül.
External ID a rendszer stabil kapcsolati azonosítója: CRM ID, ügyfél ⟦16155 vagy e-mail, telefonszám. Inkább változtathatatlan rendszert ID. Opcionálisan adja hozzá a External Source-t a rendszerek közötti ütközések elkerülése és a webhook-korreláció egyértelművé tétele érdekében.
Ha a profilnak egy aktív sablonja van, a template_id elhagyható, és a 7stamp automatikusan kiválasztja. Ha több aktív sablonja van, adja át a kívánt template_id-t. Először olvassa el a GET /templates-t, nehogy keményen kódoljon egy kitalált ID-t.
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
}'Jelentkezzen be a 7stamp Admin címre, és hozzon létre egy kulcsot: API Integrations → API Keys → Add API Key. Tárolja a titkos kezelőjében, ne a forráskódban vagy egy ügyféloldali alkalmazásban.
Állítsa az URL alapértéket https://api.7loc.com/cards-api-ra, és adja hozzá a Authorization: Bearer, majd a kulcsot minden szerveroldali kéréshez.
Először hívja a GET /templates számot. A sikeres válasz megerősíti a tokent, és megjeleníti az adott munkahelyen elérhető sablonokat/profile.
Válassza ki a stabil External ID és az opcionális External Source számot a saját rendszeréből. Pontosan ugyanazt az identitáspárt használja a létrehozási, vizsgálati, keresési és webhook logikában.
Hívja a POST /cards/invite számot egy eldobható tesztérintkezővel. Ellenőrizze a visszaküldött URL telepítést, mielőtt automatizálná a valódi ügyfelekhez való eljuttatást.
A POST /cards/scan, utalvány vagy üzenetműveletek hozzáadása csak azután lehetséges, ha a saját háttérrendszerében már rendelkezik naplózási, hibakezelési és biztonságos újrapróbálkozási /idempotency stratégiával.
A nyilvános Swagger/OpenAPI hivatkozás tartalmazza az aktuális végpont-, paraméter-, kéréstörzs-, válasz- és webhook-sémákat. Az interaktív URL a https://api.7loc.com/cards-api/docs, a géppel olvasható szerződés pedig a https://api.7loc.com/cards-api/openapi.json. Olvassa el a hibakezelés végrehajtása vagy az opcionális mezők hozzáadása előtt.
A kulcs szerveroldali titkos. Ne tegye közzé a böngésző JavaScriptjében, mobilalkalmazás-csomagban, nyilvános űrlapon, képernyőképekben, Make/Zapier szövegmezőkben vagy támogatási jegyekben. Használjon szervert, biztonságos automatizálási kapcsolatot vagy titkos kezelőt. Ha a kulcsot véletlenül megosztják, vonja vissza vagy forgassa el a 7stamp Admin helyen, és frissítse az érintett kapcsolatot.
A 7stamp Admin mezőben lépjen a API Integrations → API Keys → Add API Key címre. A tokent ezután a Authorization fejlécben Bearer néven küldi el, majd a kulcsot.
Használja a https://api.7loc.com/cards-api kódot, és küldje el a Authorization: Bearer YOUR_7STAMP_API_KEY kódot minden engedélyezett kérésnél.
Csak akkor, ha a csatlakoztatott profilnak pontosan egy aktív kártyasablonja van. Ha több sablon is aktív, válassza ki a megfelelő template_id GET /templates.
Használja a API kódot egyéni POS, háttérrendszerhez, webhelyhez vagy teljes vezérléshez. Használja a Make-t a vizuális elágazási forgatókönyvekhez. Használja a Zapier-t egy többnyire lineáris trigger-művelet munkafolyamathoz. Mindhárom ugyanazon API kulcson és API szerződésen alapul.
Kapcsolódó oldalak
Következő lépés
Hozza létre a kulcsot, hívja a GET /templates számot, hozzon létre egy meghívót egy eldobható kapcsolattartó számára, majd adja hozzá a gyártási titkokat, a naplózást, az újrapróbálkozásokat és a webhook kezelést a bevált kérés köré.