Integracija programera
7stamp Integration API omogućuje CRM, platformu za e-trgovinu, POS, prilagođenu backend ili alat za automatizaciju upravljajte karticama lojalnosti novčanika pomoću identifikatora kontakta koji vaš sustav već koristi. To je univerzalna opcija kada ne postoji specijalizirana integracija.
Baza API URL je https://api.7loc.com/cards-api. Ovjerite autentičnost svakog zahtjeva s ključem API kao tokenom Bearer. Koristite povezanu referencu OpenAPI za žive sheme zahtjeva i odgovora prije izgradnje proizvodne logike.
API je strana za pisanje integracijskog stoga. Koristite ga kad god vaš vlastiti softver treba ostati operativni izvor istine dok 7stamp upravlja slojem lojalnosti novčanika.
Generirajte vezu kartice osobnog novčanika za bilo kojeg kupca u vašem sustavu. Dostavite ga putem vlastite e-pošte, SMS, push-a ili protoka unutar aplikacije. Kupac otvara poveznicu i pohranjuje karticu na Apple Wallet ili Google Wallet.
Kada se kupnja završi u vašem prilagođenom POS, kada se online narudžba plati na vašoj web stranici ili kada je usluga dovršena u vašem sustavu rezervacija, nazovite API za kreditne marke. Kartica se ažurira unutar nekoliko sekundi.
Izdajte jednokratni vaučer određenom kupcu, kreirajte tokove nagrada spremnih za kampanju i vratite status vaučera u sustave koji upravljaju financijama i kvalitetom usluge.
Ovo su javne API rute iza akcija Make i Zapier. Pročitajte točnu shemu u referenci API; nemojte izvoditi nazive polja iz druge krajnje točke.
POST /cards/invite Stvara novu osobnu instalaciju URL za vanjski kontakt.
POST /cards/invite/bulk Stvara do 100 poveznica za pozivnice u kontroliranoj seriji.
GET /cards Traži evidenciju kartica prema vanjskom identifikatoru kontakta.
GET /cards/{user_card_id} Vraća potpuno stanje jedne kartice pomoću njezinih internih 7stamp ID.
POST /cards/scan Dodaje marke po kartici ID ili External ID i bilježi izvorni redoslijed kada je isporučen.
GET /templates Popis predložaka kartica dostupnih radnom mjestu ključa/profile.
GET /templates/{template_id}/design Čita vizualno postavke za poznati predložak kartice.
POST /vouchers/issue Izdaje vaučer vlasniku kartice.
POST /messages/send Šalje push-karticu novčanika i /or sadržaj e-pošte vlasniku kartice.
Ovo su pravi 7stamp Admin zasloni. Otvorite API & Integrations, dodajte ključ, zatim ga kopirajte u sigurnu tajnu ili automatiziranu vezu na strani poslužitelja.
Kreirajte ključ u 7stamp Admin pod API Integrations → API Keys → Add API Key. Ključ pripada jednom radnom mjestu/profile, stoga izradite zasebne ključeve za razvoj i proizvodnju kada to dopuštaju postavke vašeg računa. Rotirajte ili opozovite pristup s nadzorne ploče ako je tajna otkrivena.
External ID je stabilni identifikator kontakta iz vašeg sustava: CRM ID, kupac UUID, broj telefona ili e-pošta. Radije nepromjenjivi sustav ID. Po želji dodajte External Source da biste izbjegli kolizije među sustavima i da bi korelacija web-dojavnika bila eksplicitna.
Kada profil ima jedan aktivni predložak, template_id se može izostaviti i 7stamp ga odabire automatski. Kada ima više aktivnih predložaka, proslijedite predviđeni template_id. Prvo pročitajte GET /templates umjesto da upisujete nagađanje 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 na 7stamp Admin i kreirajte ključ: API Integrations → API Keys → Add API Key. Pohranite ga u svoj tajni upravitelj, a ne u izvorni kod ili aplikaciju na strani klijenta.
Postavite bazu URL na https://api.7loc.com/cards-api i dodajte Authorization: Bearer nakon čega slijedi ključ za svaki zahtjev na strani poslužitelja.
Prvo nazovite GET /templates. Uspješan odgovor potvrđuje token i prikazuje predloške dostupne tom radnom mjestu/profile.
Odaberite stabilni External ID i izborni External Source iz vlastitog sustava. Upotrijebite potpuno isti par identiteta u logici stvaranja, skeniranja, pretraživanja i web-dojavnika.
Nazovite POST /cards/invite s jednokratnim testnim kontaktom. Provjerite vraćenu instalaciju URL prije automatizacije isporuke stvarnim kupcima.
Dodajte POST /cards/scan, radnje vaučera ili poruke tek nakon što imate strategiju evidentiranja, obrade grešaka i sigurnog ponovnog pokušaja/idempotency u vlastitoj pozadini.
Javna referenca Swagger/OpenAPI sadrži trenutnu krajnju točku, parametar, tijelo zahtjeva, odgovor i sheme web-dojavnika. Interaktivni URL je https://api.7loc.com/cards-api/docs, a strojno čitljiv ugovor je https://api.7loc.com/cards-api/openapi.json. Pročitajte ga prije implementacije obrade grešaka ili dodavanja izbornih polja.
Ključ je tajna na strani poslužitelja. Nemojte ga izlagati u JavaScriptu preglednika, paketu mobilne aplikacije, javnom obrascu, snimkama zaslona, tekstualnim poljima Make/Zapier ili prijavama za podršku. Koristite poslužitelj, sigurnu vezu za automatizaciju ili tajni upravitelj. Ako se ključ slučajno podijeli, opozovite ga ili rotirajte u 7stamp Admin i ažurirajte zahvaćenu vezu.
U 7stamp Admin idite na API Integrations → API Keys → Add API Key. Token se zatim šalje u zaglavlju Authorization kao Bearer nakon čega slijedi ključ.
Koristite https://api.7loc.com/cards-api i pošaljite Authorization: Bearer YOUR_7STAMP_API_KEY na svaki autorizirani zahtjev.
Samo kada povezani profil ima točno jedan aktivni predložak kartice. Ako je aktivno više predložaka, odaberite ispravan template_id od GET /templates.
Koristite API za prilagođenu POS, pozadinu, web mjesto ili potpunu kontrolu. Koristite Make za scenarije vizualnog grananja. Upotrijebite Zapier za uglavnom linearan tijek rada okidača. Sva tri se oslanjaju na isti ključ API i ugovor API.
Povezane stranice
Sljedeći korak
Stvorite ključ, nazovite GET /templates, izradite jednu pozivnicu za kontakt za jednokratnu upotrebu, zatim dodajte proizvodne tajne, zapisivanje, ponovne pokušaje i rukovanje webhookom oko provjerenog zahtjeva.