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ə pul kisəsi 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 pul kisəsinin loyallıq 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 pul kisəsi 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, kredit markaları üçün API nömrəsinə zəng edin. 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ə pul kisəsi-kart təkan və/or e-poçt məzmunu 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 telefon nömrəsi və ya e-poçt ünvanı. Dəyişməz sistemə üstünlük verin ID. 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
}'Sign in to 7stamp Admin and create a key: API Integrations → API Keys → Add API Key. Store it in your secret manager, not source code or a client-side application.
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 nömrəsinə zəng edin. Uğurlu cavab işarəni təsdiq edir və həmin iş yerində mövcud olan şablonları göstərir/profile.
Ö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.
Birdəfəlik sınaq kontaktı ilə POST /cards/invite nömrəsinə zəng edin. Real müştərilərə çatdırılmanı avtomatlaşdırmadan əvvəl geri qaytarılmış quraşdırmanı URL 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 nömrə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 nömrəsinə zəng edin, birdəfəlik kontakt üçün bir dəvət yaradın, sonra sübut edilmiş sorğu ətrafında istehsal sirləri, giriş, təkrar cəhdlər və veb-qanca ilə işləmə əlavə edin.