विकसक एकत्रीकरण
7stamp Integration API हे CRM, ईकॉमर्स प्लॅटफॉर्म, POS, कस्टम बॅकएंड किंवा ऑटोमेशन टूल वॉलेट लॉयल्टी कार्ड तुमच्या स्वतःच्या सिस्टमने आधीच वापरत असलेल्या कॉन्टॅक्ट आयडेंटिफायरसह व्यवस्थापित करू देते. जेव्हा विशेष एकत्रीकरण अस्तित्वात नसते तेव्हा हा सार्वत्रिक पर्याय असतो.
API बेस URL आहे https://api.7loc.com/cards-api. प्रत्येक विनंतीला Bearer टोकन म्हणून API की सह प्रमाणीकृत करा. प्रॉडक्शन लॉजिक तयार करण्यापूर्वी थेट विनंती आणि प्रतिसाद स्कीमासाठी लिंक केलेला OpenAPI संदर्भ वापरा.
API ही इंटिग्रेशन स्टॅकची राइट साइड आहे. जेव्हा जेव्हा 7stamp वॉलेट लॉयल्टी लेयर हाताळते तेव्हा तुमचे स्वतःचे सॉफ्टवेअर सत्याचे ऑपरेशनल स्त्रोत राहावे तेव्हा ते वापरा.
तुमच्या सिस्टममधील कोणत्याही ग्राहकासाठी वैयक्तिक वॉलेट कार्ड लिंक व्युत्पन्न करा. ते तुमच्या स्वतःच्या ईमेल, SMS, पुश किंवा इन-ॲप फ्लोद्वारे वितरित करा. ग्राहक लिंक उघडतो आणि कार्ड Apple Wallet किंवा Google Wallet मध्ये सेव्ह करतो.
जेव्हा तुमच्या कस्टम POS मध्ये खरेदी बंद होते, जेव्हा तुमच्या वेबसाइटवर ऑनलाइन ऑर्डर दिली जाते किंवा तुमच्या बुकिंग सिस्टममध्ये सेवा पूर्ण होते तेव्हा, क्रेडिट स्टॅम्पसाठी API ला कॉल करा. काही सेकंदात कार्ड अपडेट होते.
विशिष्ट ग्राहकाला एक-एक व्हाउचर जारी करा, मोहिमेसाठी तयार रिवॉर्ड फ्लो तयार करा आणि वित्त आणि सेवा गुणवत्ता हाताळणाऱ्या सिस्टममध्ये व्हाउचरची स्थिती परत आणा.
हे Make आणि Zapier क्रियांच्या मागे सार्वजनिक API मार्ग आहेत. API संदर्भातील अचूक स्कीमा वाचा; वेगळ्या एंडपॉईंटवरून फील्डची नावे काढू नका.
POST /cards/invite बाह्य संपर्कासाठी नवीन वैयक्तिक स्थापना URL तयार करते.
POST /cards/invite/bulk नियंत्रित बॅचमध्ये 100 आमंत्रण लिंक तयार करते.
GET /cards बाह्य संपर्क अभिज्ञापकाद्वारे कार्ड रेकॉर्ड पहा.
GET /cards/{user_card_id} एका कार्डची संपूर्ण स्थिती त्याच्या अंतर्गत 7stamp ID परत करते.
POST /cards/scan कार्ड ID किंवा External ID द्वारे स्टॅम्प जोडते आणि पुरवठा केल्यावर स्त्रोत ऑर्डर रेकॉर्ड करते.
GET /templates कीच्या कार्यस्थळावर उपलब्ध कार्ड टेम्पलेट्स सूचीबद्ध करा/profile.
GET /templates/{template_id}/design व्हिज्युअल कार्ड टेम्पलेटसाठी ज्ञात सेटिंग्ज वाचते.
POST /vouchers/issue कार्ड मालकाला व्हाउचर जारी करते.
POST /messages/send कार्ड मालकाला वॉलेट-कार्ड पुश आणि /or ईमेल सामग्री पाठवते.
या वास्तविक 7stamp Admin स्क्रीन आहेत. API आणि एकत्रीकरण उघडा, एक की जोडा, नंतर सुरक्षित सर्व्हर-साइड गुप्त किंवा ऑटोमेशन कनेक्शनमध्ये कॉपी करा.
API Integrations → API Keys → Add API Key अंतर्गत 7stamp Admin मध्ये की तयार करा. एक की एका कार्यस्थळाची आहे /profile, म्हणून जेव्हा तुमचे खाते सेटअप परवानगी देईल तेव्हा विकास आणि उत्पादनासाठी स्वतंत्र की तयार करा. गुपित उघड झाल्यास डॅशबोर्डवरून प्रवेश फिरवा किंवा रद्द करा.
External ID हा तुमच्या सिस्टममधील स्थिर संपर्क ओळखकर्ता आहे: एक CRM ID, ग्राहक UUID, फोन नंबर किंवा ईमेल. अपरिवर्तनीय प्रणाली ID ला प्राधान्य द्या. संपूर्ण प्रणालींमध्ये टक्कर टाळण्यासाठी आणि वेबहुक सहसंबंध स्पष्ट करण्यासाठी वैकल्पिकरित्या External Source जोडा.
जेव्हा प्रोफाइलमध्ये एक सक्रिय टेम्पलेट असते, तेव्हा template_id वगळले जाऊ शकते आणि 7stamp ते स्वयंचलितपणे निवडते. जेव्हा त्यात एकाधिक सक्रिय टेम्पलेट्स असतात, तेव्हा इच्छित template_id पास करा. अंदाजित ID हार्ड-कोडिंग करण्याऐवजी प्रथम GET /templates वाचा.
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 मध्ये साइन इन करा आणि एक की तयार करा: API Integrations → API Keys → Add API Key. ते तुमच्या गुप्त व्यवस्थापकामध्ये साठवा, सोर्स कोड किंवा क्लायंट-साइड ॲप्लिकेशनमध्ये नाही.
बेस URL ला https://api.7loc.com/cards-api वर सेट करा आणि Authorization: Bearer नंतर प्रत्येक सर्व्हर-साइड विनंतीसाठी की जोडा.
प्रथम GET /templates वर कॉल करा. यशस्वी प्रतिसाद टोकनची पुष्टी करतो आणि त्या कार्यस्थळावर उपलब्ध टेम्पलेट दाखवतो /profile.
आपल्या स्वतःच्या सिस्टममधून स्थिर External ID आणि पर्यायी External Source निवडा. तयार करा, स्कॅन करा, लुकअप करा आणि वेबहुक लॉजिकमध्ये नेमकी समान ओळख जोडी वापरा.
डिस्पोजेबल चाचणी संपर्कासह POST /cards/invite वर कॉल करा. वास्तविक ग्राहकांना स्वयंचलित वितरण करण्यापूर्वी URL परत केलेले इंस्टॉल सत्यापित करा.
POST /cards/scan, व्हाउचर किंवा संदेश क्रिया तुमच्या स्वतःच्या बॅकएंडमध्ये लॉगिंग, त्रुटी हाताळणी आणि सुरक्षित पुन्हा प्रयत्न /idempotency रणनीती झाल्यानंतरच जोडा.
सार्वजनिक Swagger/OpenAPI संदर्भामध्ये वर्तमान एंडपॉइंट, पॅरामीटर, विनंती-मुख्य भाग, प्रतिसाद आणि वेबहुक स्कीमा समाविष्ट आहेत. परस्परसंवादी URL https://api.7loc.com/cards-api/docs आहे आणि मशीन-वाचनीय करार https://api.7loc.com/cards-api/openapi.json. आहे त्रुटी हाताळणी लागू करण्यापूर्वी किंवा पर्यायी फील्ड जोडण्यापूर्वी ते वाचा.
की सर्व्हर-साइड गुपित आहे. ब्राउझर JavaScript, मोबाइल ॲप बंडल, सार्वजनिक फॉर्म, स्क्रीनशॉट, Make/Zapier मजकूर फील्ड किंवा समर्थन तिकीटांमध्ये ते उघड करू नका. सर्व्हर, सुरक्षित ऑटोमेशन कनेक्शन किंवा गुप्त व्यवस्थापक वापरा. की कधीही चुकून शेअर केली असल्यास, ती रद्द करा किंवा 7stamp Admin मध्ये फिरवा आणि प्रभावित कनेक्शन अद्यतनित करा.
7stamp Admin मध्ये, API Integrations → API Keys → Add API Key वर जा. टोकन नंतर Authorization हेडरमध्ये Bearer नंतर की पाठवले जाते.
https://api.7loc.com/cards-api वापरा आणि प्रत्येक अधिकृत विनंतीवर Authorization: Bearer YOUR_7STAMP_API_KEY पाठवा.
कनेक्ट केलेल्या प्रोफाइलमध्ये अगदी एक सक्रिय कार्ड टेम्पलेट असेल तेव्हाच. एकाधिक टेम्पलेट सक्रिय असल्यास, GET /templates.
सानुकूल POS, बॅकएंड, साइट किंवा पूर्ण नियंत्रणासाठी API वापरा. व्हिज्युअल ब्रांचिंग परिस्थितींसाठी Make वापरा. मुख्यतः रेखीय ट्रिगर-ॲक्शन वर्कफ्लोसाठी Zapier वापरा. तिघेही समान API की आणि API करारावर अवलंबून आहेत.
संबंधित पृष्ठे
पुढील चरण
की तयार करा, GET /templates वर कॉल करा, डिस्पोजेबल संपर्कासाठी एक आमंत्रण तयार करा, नंतर सिद्ध केलेल्या विनंतीच्या आसपास उत्पादन रहस्ये, लॉगिंग, पुन्हा प्रयत्न आणि वेबहुक हाताळणी जोडा.