Dasturchilar integratsiyasi
7stamp Integration API CRM, elektron tijorat platformasi, POS, maxsus backend yoki avtomatlashtirish vositasiga tizimingiz allaqachon foydalanadigan kontakt identifikatori bilan hamyon sodiqlik kartalarini boshqarish imkonini beradi. Ixtisoslashgan integratsiya mavjud bo'lmaganda, bu universal variant.
API bazasi URL https://api.7loc.com/cards-api. hisoblanadi. Ishlab chiqarish mantigʻini yaratishdan oldin jonli soʻrov va javob sxemalari uchun bogʻlangan OpenAPI maʼlumotnomasidan foydalaning.
API integratsiya stekining yozish tomonidir. 7stamp hamyonning sodiqlik qatlami bilan shug'ullanar ekan, o'zingizning dasturiy ta'minotingiz haqiqatning operatsion manbai bo'lib qolishi kerak bo'lganda undan foydalaning.
Tizimdagi har qanday mijoz uchun shaxsiy hamyon kartasi havolasini yarating. Uni shaxsiy elektron pochta, SMS, push yoki ilova ichidagi oqim orqali yetkazib bering. Mijoz havolani ochadi va kartani Apple Wallet yoki Google Wallet raqamlariga saqlaydi.
Shaxsiy POS-da xarid yopilganda, veb-saytingizda onlayn buyurtma toʻlanganda yoki bron qilish tizimingizda xizmat tugallanganda, kredit markalarini olish uchun API raqamiga qoʻngʻiroq qiling. Bir necha soniya ichida karta yangilanadi.
Muayyan mijozga bir martalik vaucher bering, kampaniyaga tayyor mukofot oqimlarini yarating va moliya va xizmat sifati bilan shug‘ullanuvchi tizimlarga vaucher holatini qaytarib oling.
Bular Make va Zapier harakatlari ortidagi ommaviy API marshrutlari. API ma'lumotnomasida aniq sxemani o'qing; maydon nomlarini boshqa so'nggi nuqtadan chiqarmang.
POST /cards/invite Tashqi kontakt uchun yangi shaxsiy oʻrnatish URL yaratadi.
POST /cards/invite/bulk Boshqariladigan to'plamda 100 tagacha taklif havolalarini yaratadi.
GET /cards Tashqi kontakt identifikatori orqali karta yozuvlarini qidiradi.
GET /cards/{user_card_id} Bitta kartaning toʻliq holatini ichki 7stamp ID orqali qaytaradi.
POST /cards/scan ID yoki External ID kartalari boʻyicha shtamplar qoʻshadi va yetkazib berilganda manba tartibini yozib oladi.
GET /templates Kalitning ish joyida mavjud boʻlgan karta shablonlari roʻyxati/profile.
GET /templates/{template_id}/design Ma'lum karta shablonining vizual sozlamalarini o'qiydi.
POST /vouchers/issue Karta egasiga vaucher beradi.
POST /messages/send Karta egasiga hamyon-karta push va/or elektron pochta xabarlarini yuboradi.
Bu haqiqiy 7stamp Admin ekranlar. API & Integrations-ni oching, kalit qo'shing, so'ngra uni xavfsiz server siriga yoki avtomatlashtirish ulanishiga nusxalang.
7stamp Admin da API Integrations → API Keys → Add API Key ostida kalit yarating. Kalit bitta ish joyiga tegishli/profile, shuning uchun hisobingiz sozlamalari ruxsat berganda ishlab chiqish va ishlab chiqarish uchun alohida kalitlarni yarating. Agar sir oshkor bo'lsa, asboblar panelidan kirishni aylantiring yoki bekor qiling.
External ID bu tizimingizdagi barqaror kontakt identifikatori: CRM ID, mijoz UUID telefon raqami yoki elektron pochta manzili. ID oʻzgarmas tizimni afzal koʻring. Tizimlar boʻylab toʻqnashuvlarning oldini olish va vebhuk korrelyatsiyasini aniq qilish uchun ixtiyoriy ravishda External Source qoʻshing.
Profilda bitta faol shablon bo‘lsa, template_id qoldirilishi mumkin va 7stamp uni avtomatik tanlaydi. Agar u bir nechta faol shablonga ega bo'lsa, mo'ljallangan template_id raqamini o'tkazing. Taxmin qilingan ID ni qattiq kodlashdan ko'ra, avval GET /templates ni o'qing.
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 bazasini https://api.7loc.com/cards-api qilib oʻrnating va Authorization: Bearer, soʻngra har bir server tomonidagi soʻrov uchun kalitni qoʻshing.
Avval GET /templates raqamiga qo'ng'iroq qiling. Muvaffaqiyatli javob tokenni tasdiqlaydi va oʻsha ish joyida mavjud shablonlarni koʻrsatadi/profile.
Oʻz tizimingizdan barqaror External ID va ixtiyoriy External Source ni tanlang. Yaratish, skanerlash, qidirish va webhook mantig'ida aynan bir xil identifikatsiya juftidan foydalaning.
Bir martalik sinov kontakti bilan POST /cards/invite raqamiga qo'ng'iroq qiling. Haqiqiy mijozlarga yetkazib berishni avtomatlashtirishdan oldin qaytarilgan oʻrnatishni URL tekshiring.
POST /cards/scan, vaucher yoki xabar amallarini faqat tizimga kirganingizdan, xatolarni qayta ishlashingizdan va oʻz serveringizda xavfsiz qayta urinish/idempotency strategiyasidan soʻng qoʻshing.
Ommaviy Swagger/OpenAPI maʼlumotnomasi joriy soʻnggi nuqta, parametr, soʻrov tanasi, javob va veb-huk sxemalarini oʻz ichiga oladi. Interaktiv URL https://api.7loc.com/cards-api/docs va mashinada oʻqiladigan shartnoma https://api.7loc.com/cards-api/openapi.json. Xatolarni qayta ishlash yoki ixtiyoriy maydonlarni qoʻshishdan oldin uni oʻqing.
Kalit server tomonidagi sirdir. Uni JavaScript brauzerida, mobil ilovalar toʻplamida, umumiy shaklda, skrinshotlarda, Make/Zapier matn maydonlarida yoki qoʻllab-quvvatlash chiptalarida koʻrsatmang. Server, xavfsiz avtomatlashtirish ulanishi yoki maxfiy boshqaruvchidan foydalaning. Agar kalit tasodifan ulashilgan boʻlsa, uni 7stamp Admin da bekor qiling yoki aylantiring va taʼsirlangan ulanishni yangilang.
7stamp Admin da API Integrations → API Keys → Add API Key raqamiga oʻting. Keyin token Authorization sarlavhasida Bearer va undan keyin kalit sifatida yuboriladi.
Har bir ruxsat berilgan soʻrov uchun https://api.7loc.com/cards-api raqamidan foydalaning va Authorization: Bearer YOUR_7STAMP_API_KEY kodini yuboring.
Faqat ulangan profilda bitta faol karta shabloniga ega bo'lganda. Agar bir nechta andozalar faol boʻlsa, GET /templates.
Maxsus POS, backend, sayt yoki toʻliq boshqaruv uchun API dan foydalaning. Vizual tarmoqlanish stsenariylari uchun Make dan foydalaning. Zapier dan asosan chiziqli ishga tushirish harakati uchun foydalaning. Uchalasi ham bir xil API kalit va API shartnomaga tayanadi.
Aloqador sahifalar
Keyingi qadam
Kalitni yarating, GET /templates raqamiga qo‘ng‘iroq qiling, bir martalik kontakt uchun bitta taklif yarating, so‘ngra tasdiqlangan so‘rov atrofida ishlab chiqarish sirlarini, jurnalni qayd etish, qayta urinishlar va veb-huk bilan ishlashni qo‘shing.