Integracija razvijalca
7stamp Integration API omogoča CRM, platformo za e-trgovino, POS, zaledje po meri ali orodje za avtomatizacijo upravljajte kartice zvestobe denarnice z identifikatorjem stika, ki ga vaš sistem že uporablja. To je univerzalna možnost, ko specializirana integracija ne obstaja.
API osnova URL je https://api.7loc.com/cards-api. Preverjanje pristnosti vsake zahteve s ključem API kot žeton Bearer. Uporabite povezano referenco OpenAPI za sheme zahtev in odgovorov v živo, preden zgradite proizvodno logiko.
API je pisalna stran integracijskega sklada. Uporabite ga, kadar naj vaša lastna programska oprema ostane operativni vir resnice, medtem ko 7stamp skrbi za plast zvestobe denarnice.
Ustvarite povezavo kartice osebne denarnice za katero koli stranko v vašem sistemu. Dostavite ga prek lastne e-pošte, SMS, potiskanja ali toka v aplikaciji. Stranka odpre povezavo in kartico shrani na Apple Wallet ali Google Wallet.
Ko se nakup zaključi v vašem prilagojenem POS, ko je spletno naročilo plačano na vašem spletnem mestu ali ko je storitev opravljena v vašem rezervacijskem sistemu, pokličite API za dobroimetje. Kartica se posodobi v nekaj sekundah.
Izdajte enkratni vavčer določeni stranki, ustvarite tokove nagrad, pripravljene za kampanjo, in potegnite status vavčerja nazaj v sisteme, ki obravnavajo finance in kakovost storitev.
To so javne API poti za dejanja Make in Zapier. Preberite natančno shemo v sklicu API; ne sklepajte imen polj iz druge končne točke.
POST /cards/invite Ustvari novo osebno namestitev URL za zunanji stik.
POST /cards/invite/bulk Ustvari do 100 povezav za povabila v nadzorovani seriji.
GET /cards Poišče zapise kartic po zunanjem identifikatorju kontakta.
GET /cards/{user_card_id} Vrne celotno stanje ene kartice z njenim notranjim 7stamp ID.
POST /cards/scan Doda žige po kartici ID ali External ID in zabeleži izvorni vrstni red, ko je na voljo.
GET /templates Seznam predlog kartic, ki so na voljo za delovno mesto ključa/profile.
GET /templates/{template_id}/design Bere vizualne nastavitve za znano predlogo kartice.
POST /vouchers/issue Izda bon lastniku kartice.
POST /messages/send Pošlje vsebino kartice denarnice in /or lastniku kartice.
To so pravi zasloni 7stamp Admin. Odprite API & Integrations, dodajte ključ in ga nato kopirajte v varno skrivno ali avtomatizirano povezavo na strani strežnika.
Ustvarite ključ v 7stamp Admin pod API Integrations → API Keys → Add API Key. Ključ pripada enemu delovnemu mestu/profile, zato ustvarite ločene ključe za razvoj in proizvodnjo, ko to omogoča nastavitev vašega računa. Obrnite ali prekličite dostop z nadzorne plošče, če je skrivnost razkrita.
External ID je stabilen identifikator stika iz vašega sistema: CRM ID, stranka UUID, telefonska številka ali e-pošta. Raje nespremenljiv sistem ID. Po želji dodajte External Source, da se izognete kolizijam med sistemi in da bo korelacija webhook eksplicitna.
Ko ima profil eno aktivno predlogo, lahko template_id izpustite in 7stamp jo izbere samodejno. Ko ima več aktivnih predlog, posredujte predvideno template_id. Najprej preberite GET /templates, namesto da bi trdo kodirali ugibano 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
}'Prijavite se v 7stamp Admin in ustvarite ključ: API Integrations → API Keys → Add API Key. Shranite ga v svoj skrivni upravitelj, ne v izvorno kodo ali aplikacijo na strani odjemalca.
Nastavite osnovo URL na https://api.7loc.com/cards-api in dodajte Authorization: Bearer, ki mu sledi ključ za vsako zahtevo na strani strežnika.
Najprej pokličite GET /templates. Uspešen odgovor potrdi žeton in prikaže predloge, ki so na voljo za to delovno mesto/profile.
Izberite stabilno External ID in izbirno External Source iz svojega sistema. Uporabite popolnoma enak par identitet v logiki ustvarjanja, skeniranja, iskanja in webhooka.
Pokličite POST /cards/invite s testnim kontaktom za enkratno uporabo. Preverite vrnjeno namestitev URL, preden avtomatizirate dostavo pravim strankam.
Dodajte POST /cards/scan, vavčer ali sporočilna dejanja šele, ko imate v lastnem ozadju strategijo beleženja, obravnavanja napak in varnega ponovnega poskusa/idempotency.
Javna referenca Swagger/OpenAPI vsebuje trenutno končno točko, parameter, telo zahteve, odgovor in sheme webhook. Interaktivna URL je https://api.7loc.com/cards-api/docs in strojno berljiva pogodba je https://api.7loc.com/cards-api/openapi.json. Preberite jo, preden uvedete obravnavanje napak ali dodate izbirna polja.
Ključ je skrivnost na strani strežnika. Ne izpostavljajte ga v JavaScriptu brskalnika, paketu mobilnih aplikacij, javnem obrazcu, posnetkih zaslona, besedilnih poljih Make/Zapier ali prijavah za podporo. Uporabite strežnik, varno povezavo za avtomatizacijo ali tajnega upravitelja. Če je ključ slučajno deljen, ga prekličite ali obrnite v 7stamp Admin in posodobite prizadeto povezavo.
V 7stamp Admin pojdite na API Integrations → API Keys → Add API Key. Žeton se nato pošlje v glavi Authorization kot Bearer, ki mu sledi ključ.
Uporabite https://api.7loc.com/cards-api in pošljite Authorization: Bearer YOUR_7STAMP_API_KEY za vsako avtorizirano zahtevo.
Samo, če ima povezani profil točno eno aktivno predlogo kartice. Če je aktivnih več predlog, izberite pravilno template_id izmed GET /templates.
Uporabite API za POS po meri, zaledje, spletno mesto ali popoln nadzor. Uporabite Make za scenarije vizualnega razvejanja. Uporabite Zapier za večinoma linearni potek dela sprožilnega dejanja. Vsi trije se zanašajo na isti ključ API in pogodbo API.
Sorodne strani
Naslednji korak
Ustvarite ključ, pokličite GET /templates, ustvarite eno povabilo za stik za enkratno uporabo, nato dodajte proizvodne skrivnosti, beleženje, ponovne poskuse in ravnanje s spletnim kljukom okoli preverjene zahteve.