Izstrādātāju integrācija
7stamp Integration API ļauj CRM, e-komercijas platformai, POS, pielāgotai aizmugursistēmai vai automatizācijas rīkam pārvaldīt maka lojalitātes kartes ar kontaktpersonas identifikatoru, ko jau izmanto jūsu sistēma. Tā ir universāla iespēja, ja nepastāv specializēta integrācija.
API bāze URL ir https://api.7loc.com/cards-api. Autentificējiet katru pieprasījumu, izmantojot atslēgu API kā marķieri Bearer. Pirms ražošanas loģikas izveides izmantojiet saistīto OpenAPI atsauci tiešsaistes pieprasījumu un atbilžu shēmām.
API ir integrācijas steka rakstīšanas puse. Izmantojiet to ikreiz, kad jūsu programmatūrai vajadzētu palikt par darbības patiesības avotu, kamēr 7stamp apstrādā maka lojalitātes slāni.
Generate a personal wallet card link for any customer in your system. Piegādājiet to, izmantojot savu e-pastu, 26662⟧, push vai lietotnes plūsmu. Klients atver saiti un saglabā karti uz Apple Wallet vai Google Wallet.
Kad pirkums tiek slēgts jūsu pielāgotajā POS, kad tiešsaistes pasūtījums tiek apmaksāts jūsu vietnē vai pakalpojums ir pabeigts jūsu rezervēšanas sistēmā, zvaniet pa tālruni API, lai iegūtu kredītzīmogus. Karte tiek atjaunināta dažu sekunžu laikā.
Izsniedziet vienreizēju kuponu konkrētam klientam, izveidojiet kampaņām gatavas atlīdzības plūsmas un atgrieziet kupona statusu sistēmās, kas pārvalda finanšu un pakalpojumu kvalitāti.
Šie ir publiskie API maršruti aiz darbībām Make un Zapier. Izlasiet precīzu shēmu atsaucē API; neseciniet lauku nosaukumus no cita galapunkta.
POST /cards/invite Izveido jaunu personīgo instalāciju URL ārējam kontaktam.
POST /cards/invite/bulk Izveido līdz 100 uzaicinājuma saitēm kontrolētā grupā.
GET /cards Meklē karšu ierakstus pēc ārējā kontakta identifikatora.
GET /cards/{user_card_id} Atgriež pilnu vienas kartes stāvokli ar tās iekšējo 7stamp ID.
POST /cards/scan Pievieno zīmogus ar karti ID vai External ID un reģistrē avota pasūtījumu, kad tas tiek piegādāts.
GET /templates Uzskaita atslēgas darba vietai pieejamās karšu veidnes/profile.
GET /templates/{template_id}/design Nolasa vizuālos iestatījumus zināmai kartes veidnei.
POST /vouchers/issue Izsniedz kartes īpašniekam kuponu.
POST /messages/send Nosūta kartes īpašniekam maka kartes informatīvo un/or e-pasta saturu.
Šie ir īsti 7stamp Admin ekrāni. Atveriet API un integrācijas, pievienojiet atslēgu un pēc tam kopējiet to drošā servera puses slepenajā vai automatizācijas savienojumā.
Izveidojiet atslēgu laukā 7stamp Admin zem API Integrations → API Keys → Add API Key. Atslēga pieder vienai darba vietai/profile, tāpēc izveidojiet atsevišķas atslēgas izstrādei un ražošanai, kad to atļauj jūsu konta iestatīšana. Pagrieziet vai atsauciet piekļuvi informācijas panelim, ja tiek atklāts kāds noslēpums.
External ID ir stabils kontaktpersonas identifikators no jūsu sistēmas: CRM ID, klienta ⟦26671 vai e-pasts, tālruņa numurs. Dodiet priekšroku nemainīgai sistēmai ID. Pēc izvēles pievienojiet External Source, lai izvairītos no sadursmēm starp sistēmām un lai tīmekļa aizķeres korelācija būtu skaidra.
Ja profilam ir viena aktīva veidne, template_id var izlaist un 7stamp to atlasa automātiski. Ja tam ir vairākas aktīvas veidnes, nododiet paredzēto template_id. Vispirms izlasiet GET /templates, nevis stingri iekodējiet uzminēto 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
}'Pierakstieties uz 7stamp Admin un izveidojiet atslēgu: API Integrations → API Keys → Add API Key. Saglabājiet to savā slepenajā pārvaldniekā, nevis avota kodā vai klienta puses lietojumprogrammā.
Iestatiet bāzi URL uz https://api.7loc.com/cards-api un katram servera pieprasījumam pievienojiet Authorization: Bearer, kam seko atslēga.
Vispirms zvaniet GET /templates. Veiksmīga atbilde apstiprina marķieri un parāda šai darba vietai pieejamās veidnes/profile.
Izvēlieties stabilo External ID un izvēles External Source no savas sistēmas. Izmantojiet tieši to pašu identitātes pāri izveides, skenēšanas, uzmeklēšanas un tīmekļa aizķeres loģikā.
Zvaniet POST /cards/invite, izmantojot vienreiz lietojamo testa kontaktu. Pirms automatizēt piegādes reāliem klientiem pārbaudiet atgriezto instalāciju URL.
Pievienojiet POST /cards/scan, kuponu vai ziņojumu darbības tikai pēc reģistrēšanas, kļūdu apstrādes un drošas atkārtošanas stratēģijas/idempotency savā aizmugursistēmā.
Publiskā atsauce Swagger/OpenAPI satur pašreizējā galapunkta, parametra, pieprasījuma pamatteksta, atbildes un tīmekļa aizķeres shēmas. Interaktīvais URL ir https://api.7loc.com/cards-api/docs, un mašīnlasāmais līgums ir https://api.7loc.com/cards-api/openapi.json. Izlasiet to pirms kļūdu apstrādes ieviešanas vai izvēles lauku pievienošanas.
Atslēga ir servera puses noslēpums. Neatklājiet to pārlūkprogrammas JavaScript, mobilo lietotņu komplektā, publiskā veidlapā, ekrānuzņēmumos, teksta laukos Make/Zapier vai atbalsta biļetēs. Izmantojiet serveri, drošu automatizācijas savienojumu vai slepeno pārvaldnieku. Ja atslēga kādreiz tiek nejauši kopīgota, atsauciet vai pagrieziet to 7stamp Admin un atjauniniet ietekmēto savienojumu.
Sadaļā 7stamp Admin dodieties uz API Integrations → API Keys → Add API Key. Pēc tam marķieris tiek nosūtīts galvenē Authorization kā Bearer, kam seko atslēga.
Izmantojiet https://api.7loc.com/cards-api un nosūtiet Authorization: Bearer YOUR_7STAMP_API_KEY katram autorizētajam pieprasījumam.
Tikai tad, ja pievienotajam profilam ir tieši viena aktīva kartes veidne. Ja ir aktīvas vairākas veidnes, atlasiet pareizo template_id no GET /templates.
Izmantojiet API, lai iegūtu pielāgotu POS, aizmugursistēmu, vietni vai pilnu vadību. Vizuālas sazarošanas scenārijiem izmantojiet Make. Izmantojiet Zapier galvenokārt lineārai aktivizētāja darbību darbplūsmai. Visi trīs paļaujas uz vienu un to pašu atslēgu API un līgumu API.
Nākamais solis
Izveidojiet atslēgu, zvaniet GET /templates, izveidojiet vienu uzaicinājumu vienreizējai kontaktpersonai, pēc tam pievienojiet ražošanas noslēpumus, reģistrēšanu, atkārtotus mēģinājumus un tīmekļa aizķeres apstrādi atbilstoši pārbaudītajam pieprasījumam.