የገንቢ ውህደት

7stamp REST API

ይገኛል።

7stamp Integration API CRM፣ ኢኮሜርስ ፕላትፎርም፣ POS፣ ብጁ ጀርባ ወይም አውቶሜሽን መሳሪያ የኪስ ቦርሳ ታማኝነት ካርዶችን የእራስዎ ስርዓት አስቀድሞ በሚጠቀምበት የእውቂያ መለያ እንዲያስተዳድር ያስችላል። ልዩ ውህደት በማይኖርበት ጊዜ ሁለንተናዊ አማራጭ ነው.

የ API መሰረት URL ነው https://api.7loc.com/cards-api. እያንዳንዱን ጥያቄ በAPI ቁልፍ እንደ Bearer ማስመሰያ ያረጋግጡ። የምርት አመክንዮ ከመገንባቱ በፊት ለቀጥታ ጥያቄ እና ምላሽ መርሃ ግብሮች የተገናኘውን ⟦831 ማጣቀሻ ይጠቀሙ።

ክፍት API ዋቢ ክፍት OpenAPI JSON

በ ⟦845 ምን ማድረግ ይችላሉ

API የውህደት ቁልል የጽሁፍ ጎን ነው። 7stamp የኪስ ቦርሳ ታማኝነትን በሚይዝበት ጊዜ የእራስዎ ሶፍትዌር የእውነት የስራ ምንጭ ሆኖ በሚቆይበት ጊዜ ይጠቀሙበት።

ካርዶችን ከእራስዎ ሶፍትዌር አውጡ

በስርዓትዎ ውስጥ ላለ ለማንኛውም ደንበኛ የግል የኪስ ቦርሳ ካርድ አገናኝ ይፍጠሩ። በራስዎ ኢሜይል፣ SMS፣ ፑሽ ወይም የውስጠ-መተግበሪያ ፍሰት በኩል አድርሱት። ደንበኛው ሊንኩን ከፍቶ ካርዱን ወደ Apple Wallet ወይም Google Wallet ያስቀምጣል።

የክሬዲት ማህተሞች ከማንኛውም ምንጭ

አንድ ግዢ በእርስዎ ብጁ POS ሲዘጋ፣ በድር ጣቢያዎ ላይ የኦንላይን ማዘዣ ሲከፈል ወይም በቦታ ማስያዣ ስርዓትዎ ውስጥ አገልግሎት ሲጠናቀቅ፣ ወደ ክሬዲት ስታምፕ API ይደውሉ። ካርዱ በሰከንዶች ውስጥ ይዘምናል።

ቫውቸሮችን እና ዘመቻዎችን ያስተዳድሩ

የአንድ ጊዜ ቫውቸር ለአንድ የተወሰነ ደንበኛ ይስጡ፣ ለዘመቻ ዝግጁ የሆኑ የሽልማት ፍሰቶችን ይፍጠሩ እና የቫውቸር ሁኔታን የፋይናንስ እና የአገልግሎት ጥራትን ወደ ሚቆጣጠሩ ስርዓቶች ይጎትቱ።

የሰነድ ውህደት API ስራዎች

እነዚህ ከ Make እና Zapier ድርጊቶች በስተጀርባ ያሉ የህዝብ API መንገዶች ናቸው። ትክክለኛውን እቅድ በ ⟦916 ማጣቀሻ ውስጥ ያንብቡ; የመስክ ስሞችን ከተለየ የመጨረሻ ነጥብ አይገምቱ።

ካርዶች 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 የኢሜል ይዘትን ለካርድ ባለቤት ይልካል።

API ቁልፍ የት መፍጠር እና መቅዳት እንደሚቻል

እነዚህ እውነተኛ ⟦925 ስክሪኖች ናቸው። API እና ውህደትን ይክፈቱ፣ ቁልፍ ያክሉ እና ወደ ደህንነቱ የተጠበቀ የአገልጋይ ሚስጥራዊ ወይም አውቶማቲክ ግንኙነት ይቅዱ።

7stamp Admin API እና ውህደቶች ስክሪን የAdd API Key አዝራሩን የሚያሳይ እና ⟦930 ፍጠር ቁልፍ መገናኛ — ደረጃ 1 - በግራ አሰሳ ውስጥ API እና ውህደትን ይምረጡ **API Keys** ን ይክፈቱ ፣ **Add API Key** ን ይምረጡ እና ተገቢውን የሰራተኛ መግቢያ ይምረጡ እና ቁልፉን ያመነጩ።

አዲስ የተፈጠረ API ቁልፍ እና የቅጂ መቆጣጠሪያውን የሚያሳይ ንግግር 7stamp Admin — ደረጃ 2 - አዲሱን ቁልፍ ወደ የይለፍ ቃል አስተዳዳሪ፣ የአገልጋይ ጎን ሚስጥር ወይም ደህንነቱ የተጠበቀ የMake/Zapier ግንኙነት ይቅዱ። ወደ ምንጭ ኮድ፣ የአሳሽ መተግበሪያ ወይም የድጋፍ ትኬት ላይ አይለጥፉት።

ኮድ ከማስቀመጥዎ በፊት የሚደረጉ ሶስት ውሳኔዎች

API ቁልፍ ወሰን

ቁልፉን በ7stamp Admin በAPI Integrations → API Keys → Add API Key ስር ይፍጠሩ። ቁልፍ የአንድ የስራ ቦታ ነው/profile፣ስለዚህ መለያዎ ማዋቀር ሲፈቅድ የተለየ ለልማት እና ለማምረት ቁልፎችን ይፍጠሩ። ምስጢር ከተጋለጠ ከዳሽቦርዱ ላይ ያሽከርክሩ ወይም ይሰርዙ።

የደንበኛ ማንነት

External ID የተረጋጋ የእውቂያ መለያ ከእርስዎ ስርዓት ነው፡- CRM ID፣ ደንበኛ UUID፣ ስልክ ቁጥር ወይም ኢሜል። የማይለወጥ ስርዓት ይምረጡ ID። በስርዓቶች ላይ ግጭቶችን ለማስወገድ እና የዌብ መንጠቆን ግልጽ ለማድረግ እንደ አማራጭ External Source ይጨምሩ።

የአብነት ምርጫ

ፕሮፋይሉ አንድ ገባሪ አብነት ሲኖረው፣ template_id መተው ይቻላል እና 7stamp በራስ ሰር ይመርጣል። ብዙ ንቁ አብነቶች ሲኖሩት፣ የታሰበውን template_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
  }'

ከ API ቁልፍ ወደ መጀመሪያ የተሳካ ጥያቄ

ወደ 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 በራስህ ጀርባ ላይ ጨምር።

⟦872 ማጣቀሻውን እንደ ውሉ ይጠቀሙ

የህዝብ Swagger/OpenAPI ማጣቀሻ የአሁኑን የመጨረሻ ነጥብ፣ ግቤት፣ ጥያቄ-አካል፣ ምላሽ እና የድር መንጠቆ ንድፎችን ይዟል። በይነተገናኝ URL https://api.7loc.com/cards-api/docs ሲሆን በማሽን የሚነበበው ኮንትራት https://api.7loc.com/cards-api/openapi.json. የስህተት አያያዝን ከመተግበሩ ወይም አማራጭ ቦታዎችን ከመጨመርዎ በፊት ያንብቡት።

ማረጋገጫ እና ቁልፍ ደህንነት

ቁልፉ የአገልጋይ ወገን ሚስጥር ነው። በአሳሽ ጃቫስክሪፕት፣ የሞባይል መተግበሪያ ቅርቅብ፣ ይፋዊ ቅጽ፣ ቅጽበታዊ ገጽ እይታ፣ Make/Zapier የጽሑፍ መስኮች ወይም የድጋፍ ትኬቶችን አታጋልጡት። አገልጋይ፣ ደህንነቱ የተጠበቀ አውቶሜሽን ግንኙነት ወይም ሚስጥራዊ አስተዳዳሪ ይጠቀሙ። ቁልፉ በድንገት የተጋራ ከሆነ ይሽሩት ወይም በ7stamp Admin ያሽከርክሩት እና የተጎዳውን ግንኙነት ያዘምኑ።

በተደጋጋሚ የሚጠየቁ ጥያቄዎች

7stamp API ማስመሰያ ከየት አገኛለሁ?

በ 7stamp Admin፣ ወደ API Integrations → API Keys → Add API Key ይሂዱ። ማስመሰያው ከዚያም በ Authorization ራስጌ እንደ Bearer ቁልፉ ተከትሎ ይላካል።

መሰረቱ URL እና የማረጋገጫ ዘዴ ምንድነው?

በእያንዳንዱ የተፈቀደ ጥያቄ https://api.7loc.com/cards-api ይጠቀሙ እና Authorization: Bearer YOUR_7STAMP_API_KEY ይላኩ።

መቼ ነው ⟦889 መተው የምችለው?

የተገናኘው መገለጫ በትክክል አንድ ገባሪ ካርድ አብነት ሲኖረው ብቻ ነው። ብዙ አብነቶች ንቁ ከሆኑ፣ ትክክለኛውን template_id ከGET /templates. ይምረጡ።

API፣ Make ወይም Zapier መጠቀም አለብኝ?

APIን ለብጁ POS፣ የጀርባ ጀርባ፣ ጣቢያ ወይም ሙሉ ቁጥጥር ይጠቀሙ። ለእይታ ቅርንጫፍ ሁኔታዎች Make ይጠቀሙ። በአብዛኛው መስመራዊ ቀስቅሴ-እርምጃ የስራ ፍሰት ለማግኘት Zapier ይጠቀሙ። ሦስቱም በአንድ API ቁልፍ እና API ኮንትራት ይመካሉ።

ተዛማጅ ገጾች

ክፍት ⟦902 ማጣቀሻ ክፍት OpenAPI JSON Webhook መመሪያ Make HTTP መመሪያ

ቀጣዩ ደረጃ

መጀመሪያ ትንሹን ደህንነቱ የተጠበቀ API ፍሰት ይሞክሩ

ቁልፉን ይፍጠሩ፣ ወደ GET /templates ይደውሉ፣ ሊጣል ለሚችል ግንኙነት አንድ ግብዣ ይፍጠሩ፣ ከዚያ በተረጋገጠው ጥያቄ ዙሪያ የምርት ሚስጥሮችን፣ ምዝግብ ማስታወሻዎችን፣ ዳግም ሙከራዎችን እና የዌብ መንጠቆ አያያዝን ይጨምሩ።

ክፍት ⟦910 ማጣቀሻ ክፍት ⟦911