Tərtibatçı inteqrasiyası
7Stamp Integration API CRM, e-ticarət platforması, POS, fərdi arxa hissə və ya avtomatlaşdırma alətinə öz sisteminizin artıq istifadə etdiyi kontakt identifikatoru ilə Wallet sadiqlik kartlarını idarə etməyə imkan verir. Xüsusi inteqrasiya olmadıqda universal seçimdir.
API baza URL https://api.7loc.com/cards-api. hər sorğunu API açarı ilə Bearer nişanı kimi təsdiq edin. İstehsal məntiqini qurmazdan əvvəl canlı sorğu və cavab sxemləri üçün əlaqəli OpenAPI arayışından istifadə edin.
API inteqrasiya yığınının yazı tərəfidir. 7Stamp Wallet sadiqlik qatını idarə edərkən, öz proqram təminatınız həqiqətin operativ mənbəyi olaraq qaldıqda ondan istifadə edin.
Sisteminizdə istənilən müştəri üçün şəxsi Wallet kartı linki yaradın. Onu öz e-poçtunuz, SMS, push və ya tətbiqdaxili axın vasitəsilə çatdırın. Müştəri linki açır və kartı Apple Wallet və ya Google Wallet-da saxlayır.
Şəxsi POS alış-verişiniz bağlandıqda, vebsaytınızda onlayn sifariş ödənildikdə və ya sifariş sisteminizdə xidmət tamamlandıqda, möhür vermək üçün API-ni çağırın. Kart saniyələr ərzində yenilənir.
Müəyyən bir müştəriyə birdəfəlik vauçer verin, kampaniyaya hazır mükafat axını yaradın və maliyyə və xidmət keyfiyyətini idarə edən sistemlərə çek statusunu geri çəkin.
Bunlar Make və Zapier əməliyyatlarının arxasındakı ictimai API marşrutlarıdır. API arayışında dəqiq sxemi oxuyun; sahə adlarını fərqli son nöqtədən çıxarmayın.
POST /cards/invite Xarici kontakt üçün yeni şəxsi quraşdırma URL yaradır.
POST /cards/invite/bulk Nəzarət olunan topluda 100-ə qədər dəvət linki yaradır.
GET /cards Xarici kontakt identifikatoru ilə kart qeydlərinə baxır.
GET /cards/{user_card_id} Bir kartın tam vəziyyətini daxili 7Stamp ID ilə qaytarır.
POST /cards/scan ID və ya External ID kartları ilə möhürlər əlavə edir və təchiz edildikdə mənbə sifarişini qeyd edir.
GET /templates Açarın iş yerində mövcud olan kart şablonlarını sadalayır/profile.
GET /templates/{template_id}/design Məlum kart şablonu üçün vizual parametrləri oxuyur.
POST /vouchers/issue Kart sahibinə çek verir.
POST /messages/send Kart sahibinə Wallet kartı push bildirişi və/və ya e-poçt vasitəsilə məzmun göndərir.
Bunlar real 7Stamp Admin ekranlardır. API & İnteqrasiyaları açın, açar əlavə edin, sonra onu təhlükəsiz server tərəfi sirrinə və ya avtomatlaşdırma bağlantısına kopyalayın.
API Integrations → API Keys → Add API Key altında 7Stamp Admin-də açar yaradın. Açar bir iş yerinə aiddir/profile, ona görə də hesab quraşdırmanız icazə verdikdə inkişaf və istehsal üçün ayrıca açarlar yaradın. Sirr ifşa olunarsa, idarə panelindən girişi döndərin və ya ləğv edin.
External ID sisteminizdən sabit kontakt identifikatorudur: CRM ID, müştəri UUID-si, telefon nömrəsi və ya e-poçt ünvanı. Dəyişməz sistem ID-sinə üstünlük verin. Sistemlər arasında toqquşmaların qarşısını almaq və webhook korrelyasiyasını aydın etmək üçün istəyə görə External Source əlavə edin.
Profildə bir aktiv şablon olduqda, template_id buraxıla bilər və 7Stamp onu avtomatik seçir. Onun çoxsaylı aktiv şablonları olduqda, nəzərdə tutulan template_id-i keçin. Əvvəlcə GET /templates oxuyun, təxmin edilən ID-u çətin kodlaşdırmaqdansa.
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
}'7Stamp Admin-ə daxil olun və açar yaradın: API Integrations → API Keys → Add API Key. Onu mənbə kodunda və ya müştəri tərəfindəki tətbiqdə deyil, sirlər menecerində saxlayın.
URL bazasını https://api.7loc.com/cards-api olaraq təyin edin və Authorization əlavə edin: Bearer və ardınca hər server tərəfi sorğu üçün açar.
Əvvəlcə GET /templates sorğusunu göndərin. Uğurlu cavab tokeni təsdiqləyir və həmin iş yerində/profildə mövcud olan şablonları göstərir.
Öz sisteminizdən stabil External ID və isteğe bağlı External Source seçin. Yaratmaq, skan etmək, axtarış etmək və webhook məntiqində eyni şəxsiyyət cütlüyündən istifadə edin.
Bir test kontaktı ilə POST /cards/invite sorğusunu göndərin. Real müştərilərə çatdırılmanı avtomatlaşdırmazdan əvvəl qaytarılan quraşdırma URL-ini yoxlayın.
POST /cards/scan, çek və ya mesaj əməliyyatlarını yalnız giriş, xətaların idarə edilməsi və öz arxa planınızda təhlükəsiz yenidən cəhd/idempotency strategiyasından sonra əlavə edin.
İctimai Swagger/OpenAPI arayışı cari son nöqtəni, parametri, sorğu gövdəsini, cavabı və veb-qanç sxemlərini ehtiva edir. İnteraktiv URL https://api.7loc.com/cards-api/docs və maşın tərəfindən oxuna bilən müqavilə https://api.7loc.com/cards-api/openapi.json. xətaların idarə edilməsini həyata keçirməzdən və ya əlavə sahələr əlavə etməzdən əvvəl onu oxuyun.
Açar server tərəfi sirridir. Onu JavaScript brauzerində, mobil proqram paketində, ictimai formada, skrinşotlarda, Make/Zapier mətn sahələrində və ya dəstək biletlərində ifşa etməyin. Server, təhlükəsiz avtomatlaşdırma bağlantısı və ya gizli menecerdən istifadə edin. Açar təsadüfən paylaşılıbsa, onu 7Stamp Admin-də ləğv edin və ya fırladın və təsirlənmiş əlaqəni yeniləyin.
7Stamp Admin-də API Integrations → API Keys → Add API Key bölməsinə keçin. Token daha sonra Authorization başlığına Bearer və ardınca açar kimi göndərilir.
https://api.7loc.com/cards-api istifadə edin və icazə verilən hər sorğuda Authorization: Bearer YOUR_7STAMP_API_KEY göndərin.
Yalnız qoşulmuş profildə tam olaraq bir aktiv kart şablonu olduqda. Bir neçə şablon aktivdirsə, düzgün template_id seçin GET /templates.
Fərdi POS, backend, sayt və ya tam nəzarət üçün API istifadə edin. Vizual budaqlanma ssenariləri üçün Make istifadə edin. Əsasən xətti tetikleyici iş axını üçün Zapier istifadə edin. Hər üçü eyni API açarına və API müqaviləsinə əsaslanır.
Əlaqədar səhifələr
Növbəti addım
Açarı yaradın, GET /templates sorğusunu göndərin, bir test kontaktı üçün dəvət yaradın, sonra yoxlanılmış sorğunun ətrafına istehsal sirlərinin saxlanmasını, loqlaşdırmanı, təkrar cəhdləri və webhook emalını əlavə edin.