Kūrėjų integracija
7stamp Integration API leidžia CRM, el. prekybos platformai, POS, tinkintai vidinei sistemai arba automatizavimo įrankiui tvarkyti piniginės lojalumo korteles su kontakto identifikatoriumi, kurį jau naudoja jūsų sistema. Tai universalus pasirinkimas, kai nėra specializuotos integracijos.
API bazė URL yra https://api.7loc.com/cards-api. Autentifikuokite kiekvieną užklausą naudodami raktą API kaip prieigos raktą Bearer. Prieš kurdami gamybos logiką naudokite susietą nuorodą OpenAPI tiesioginėms užklausų ir atsakymų schemoms.
API yra integravimo krūvos rašymo pusė. Naudokite jį visada, kai jūsų programinė įranga turėtų likti veikiančiu tiesos šaltiniu, o 7stamp tvarko piniginės lojalumo sluoksnį.
Sukurkite asmeninės piniginės kortelės nuorodą bet kuriam jūsų sistemos klientui. Pateikite jį savo el. paštu SMS, iš karto arba srautu programoje. Klientas atidaro nuorodą ir išsaugo kortelę numeriu Apple Wallet arba Google Wallet.
Kai baigiamas pirkimas pagal jūsų pasirinktą POS, kai jūsų svetainėje apmokamas internetinis užsakymas arba kai paslauga atliekama jūsų užsakymo sistemoje, skambinkite numeriu API, kad gautumėte kredito ženklų. Kortelė atnaujinama per kelias sekundes.
Išduokite vienkartinį kuponą konkrečiam klientui, sukurkite kampanijai paruoštus atlygio srautus ir grąžinkite kupono būseną į sistemas, kurios tvarko finansus ir paslaugų kokybę.
Tai yra vieši maršrutai API už veiksmų Make ir Zapier. Tikslią schemą skaitykite nuorodoje API; nenurodykite laukų pavadinimų iš kito galutinio taško.
POST /cards/invite Sukuria naują asmeninį išorinio kontakto diegimą URL.
POST /cards/invite/bulk Sukuria iki 100 kvietimų nuorodų kontroliuojamoje grupėje.
GET /cards Ieško kortelės įrašų pagal išorinį kontakto identifikatorių.
GET /cards/{user_card_id} Grąžina visą vienos kortelės būseną pagal jos vidinę 7stamp ID.
POST /cards/scan Prideda antspaudus kortele ID arba External ID ir įrašo šaltinio užsakymą, kai pateikiama.
GET /templates Išvardija kortelių šablonus, pasiekiamus rakto darbo vietoje/profile.
GET /templates/{template_id}/design Nuskaito žinomo kortelės šablono vaizdinius nustatymus.
POST /vouchers/issue Išduoda kuponą kortelės savininkui.
POST /messages/send Siunčia piniginės kortelės siuntimo ir/or el. pašto turinį kortelės savininkui.
Tai tikri 7stamp Admin ekranai. Atidarykite API & Integracijos, pridėkite raktą, tada nukopijuokite jį į saugų serverio slaptąjį arba automatinį ryšį.
Sukurkite raktą laukelyje 7stamp Admin, esantį API Integrations → API Keys → Add API Key. Raktas priklauso vienai darbo vietai/profile, todėl kurkite atskirus kūrimo ir gamybos raktus, kai tai leidžia paskyros sąranka. Pasukite arba atšaukite prieigą prie prietaisų skydelio, jei atskleista paslaptis.
External ID yra stabilus kontakto identifikatorius iš jūsų sistemos: CRM ID, klientas ⟦25715, el. pašto adresas, telefono numeris. Pirmenybę teikite nekintamai sistemai ID. Pasirinktinai pridėkite External Source, kad išvengtumėte sistemų susidūrimų ir kad „Webhook“ koreliacija būtų aiški.
Kai profilyje yra vienas aktyvus šablonas, template_id galima praleisti ir 7stamp pasirenka jį automatiškai. Kai yra keli aktyvūs šablonai, perduokite numatytą template_id. Pirmiausia perskaitykite GET /templates, o ne sunkiai užkoduokite spėjamą ID.
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
}'Prisijunkite prie 7stamp Admin ir sukurkite raktą: API Integrations → API Keys → Add API Key. Saugokite jį slaptoje tvarkyklėje, o ne šaltinio kode ar kliento programoje.
Nustatykite bazę URL į https://api.7loc.com/cards-api ir pridėkite Authorization: Bearer, o po to raktą prie kiekvienos serverio pusės užklausos.
Pirmiausia skambinkite GET /templates. Sėkmingas atsakymas patvirtina prieigos raktą ir parodo toje darbo vietoje pasiekiamus šablonus/profile.
Pasirinkite stabilųjį External ID ir pasirenkamą External Source iš savo sistemos. Naudokite tą pačią tapatybės porą kurdami, nuskaitydami, ieškodami ir „Webhook“ logikos.
Skambinkite POST /cards/invite naudodami vienkartinį bandomąjį kontaktą. Prieš automatizuodami pristatymą tikriems klientams, patikrinkite grąžintą diegimą URL.
Pridėkite POST /cards/scan, kuponą arba pranešimo veiksmus tik tada, kai turėsite registravimo, klaidų tvarkymo ir saugaus pakartotinio bandymo/idempotency strategiją savo foninėje sistemoje.
Viešoje nuorodoje Swagger/OpenAPI yra dabartinis galutinis taškas, parametras, užklausos turinys, atsakymas ir žiniatinklio kablio schemos. Interaktyvus URL yra https://api.7loc.com/cards-api/docs, o mašininiu būdu nuskaitoma sutartis yra https://api.7loc.com/cards-api/openapi.json. Perskaitykite ją prieš įdiegdami klaidų tvarkymą arba pridėdami pasirenkamus laukus.
Raktas yra serverio pusės paslaptis. Nenurodykite jo naršyklės „JavaScript“, mobiliųjų programų rinkinyje, viešoje formoje, ekrano kopijose, Make/Zapier teksto laukuose ar palaikymo bilietuose. Naudokite serverį, saugų automatizavimo ryšį arba slaptą tvarkyklę. Jei raktas kada nors netyčia bendrinamas, atšaukite arba pasukite jį 7stamp Admin ir atnaujinkite paveiktą ryšį.
Skiltyje 7stamp Admin eikite į API Integrations → API Keys → Add API Key. Tada prieigos raktas siunčiamas antraštėje Authorization kaip Bearer, po kurio nurodomas raktas.
Naudokite https://api.7loc.com/cards-api ir siųskite Authorization: Bearer YOUR_7STAMP_API_KEY kiekvienoje įgaliotoje užklausoje.
Tik tada, kai prijungtame profilyje yra tiksliai vienas aktyvus kortelės šablonas. Jei aktyvūs keli šablonai, pasirinkite tinkamą template_id iš GET /templates.
Naudokite API tinkintam POS, pagrindinei programai, svetainei arba visam valdymui. Naudokite Make vizualaus išsišakojimo scenarijams. Naudokite Zapier dažniausiai tiesinei trigerio veiksmų eigai. Visi trys remiasi tuo pačiu API raktu ir API sutartimi.
Susiję puslapiai
Kitas žingsnis
Sukurkite raktą, paskambinkite GET /templates, sukurkite vieną pakvietimą vienkartiniam kontaktui, tada pridėkite gamybos paslaptis, registravimą, pakartotinius bandymus ir žiniatinklio kablio tvarkymą pagal patvirtintą užklausą.