ডেভেলপার ইন্টিগ্রেশন
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 ফিরে আসা ইনস্টলটি যাচাই করুন।
আপনার নিজের ব্যাকএন্ডে লগিং, ত্রুটি হ্যান্ডলিং এবং একটি নিরাপদ পুনঃপ্রচার /idempotency কৌশল থাকলেই POST /cards/scan, ভাউচার বা বার্তা অ্যাকশন যোগ করুন।
সর্বজনীন Swagger/OpenAPI রেফারেন্সে বর্তমান এন্ডপয়েন্ট, প্যারামিটার, রিকোয়েস্ট-বডি, রেসপন্স এবং ওয়েবহুক স্কিমা রয়েছে। ইন্টারেক্টিভ URL হল https://api.7loc.com/cards-api/docs এবং মেশিন-পঠনযোগ্য চুক্তি হল https://api.7loc.com/cards-api/openapi.json. ত্রুটি হ্যান্ডলিং বা ঐচ্ছিক ক্ষেত্র যোগ করার আগে এটি পড়ুন।
কী একটি সার্ভার-সাইড গোপন। ব্রাউজার জাভাস্ক্রিপ্ট, একটি মোবাইল অ্যাপ বান্ডেল, একটি পাবলিক ফর্ম, স্ক্রিনশট, 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 কল করুন, একটি নিষ্পত্তিযোগ্য যোগাযোগের জন্য একটি আমন্ত্রণ তৈরি করুন, তারপর প্রমাণিত অনুরোধের চারপাশে উত্পাদন গোপনীয়তা, লগিং, পুনরায় চেষ্টা এবং ওয়েবহুক হ্যান্ডলিং যুক্ত করুন৷