டெவலப்பர் ஒருங்கிணைப்பு

7stamp REST API

கிடைக்கும்

7stamp Integration API ஆனது CRM, இணையவழி இயங்குதளம், POS, தனிப்பயன் பின்தளம் அல்லது ஆட்டோமேஷன் கருவி உங்கள் சொந்த அமைப்பு ஏற்கனவே பயன்படுத்தும் தொடர்பு அடையாளங்காட்டியுடன் வாலட் லாயல்டி கார்டுகளை நிர்வகிக்க உதவுகிறது. ஒரு சிறப்பு ஒருங்கிணைப்பு இல்லாதபோது இது உலகளாவிய விருப்பமாகும்.

API அடிப்படை URL என்பது https://api.7loc.com/cards-api. ஆகும். ஒவ்வொரு கோரிக்கையையும் Bearer டோக்கனாக API விசையுடன் அங்கீகரிக்கவும். உற்பத்தி தர்க்கத்தை உருவாக்கும் முன் நேரடி கோரிக்கை மற்றும் மறுமொழி திட்டங்களுக்கு இணைக்கப்பட்ட OpenAPI குறிப்பைப் பயன்படுத்தவும்.

API மூலம் நீங்கள் என்ன செய்யலாம்

API என்பது ஒருங்கிணைப்பு அடுக்கின் எழுதும் பக்கமாகும். 7stamp வாலட் லாயல்டி லேயரைக் கையாளும் போது உங்கள் சொந்த மென்பொருள் உண்மையின் செயல்பாட்டு ஆதாரமாக இருக்கும்போதெல்லாம் அதைப் பயன்படுத்தவும்.

உங்கள் சொந்த மென்பொருளிலிருந்து அட்டைகளை வழங்கவும்

உங்கள் கணினியில் உள்ள எந்தவொரு வாடிக்கையாளருக்கும் தனிப்பட்ட வாலட் கார்டு இணைப்பை உருவாக்கவும். உங்கள் சொந்த மின்னஞ்சல், SMS, புஷ் அல்லது ஆப்ஸ் ஃப்ளோ மூலம் டெலிவரி செய்யவும். வாடிக்கையாளர் இணைப்பைத் திறந்து கார்டை Apple Wallet அல்லது Google Wallet இல் சேமிக்கிறார்.

எந்த மூலத்திலிருந்தும் கடன் முத்திரைகள்

உங்கள் தனிப்பயன் POS இல் வாங்குதல் முடிவடையும் போது, ​​உங்கள் இணையதளத்தில் ஆன்லைன் ஆர்டர் செலுத்தப்படும் போது அல்லது உங்கள் முன்பதிவு அமைப்பில் ஒரு சேவை முடிந்ததும், கிரெடிட் ஸ்டாம்ப்களுக்கு API ஐ அழைக்கவும். சில நொடிகளில் அட்டை புதுப்பிக்கப்படும்.

வவுச்சர்கள் மற்றும் பிரச்சாரங்களை நிர்வகிக்கவும்

ஒரு குறிப்பிட்ட வாடிக்கையாளருக்கு ஒரு முறை வவுச்சரை வழங்கவும், பிரச்சாரத்திற்குத் தயாராக இருக்கும் வெகுமதிகளை உருவாக்கவும், மேலும் நிதி மற்றும் சேவைத் தரத்தைக் கையாளும் அமைப்புகளுக்கு வவுச்சர் நிலையை மீண்டும் பெறவும்.

ஆவணப்படுத்தப்பட்ட ஒருங்கிணைப்பு 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 மின்னஞ்சல் உள்ளடக்கத்தை அனுப்புகிறது.

API விசையை எங்கே உருவாக்கி நகலெடுக்க வேண்டும்

இவை உண்மையான 7stamp Admin திரைகள். API & ஒருங்கிணைப்புகளைத் திறந்து, ஒரு விசையைச் சேர்த்து, அதை பாதுகாப்பான சர்வர் பக்க ரகசியம் அல்லது ஆட்டோமேஷன் இணைப்பில் நகலெடுக்கவும்.

7stamp Admin API & ஒருங்கிணைப்புத் திரை Add API Key பொத்தானைக் காட்டும் மற்றும் API விசை உரையாடலை உருவாக்கவும்
படி 1 — இடதுபுற வழிசெலுத்தலில் API & ஒருங்கிணைப்புகளைத் தேர்ந்தெடுத்து, API Keys ஐத் திறந்து, Add API Key ஐத் தேர்ந்தெடுத்து, பொருத்தமான பணியாளர் உள்நுழைவைத் தேர்ந்தெடுத்து, விசையை உருவாக்கவும்.
7stamp Admin உரையாடல் புதிதாக உருவாக்கப்பட்ட API விசையையும் அதன் நகல் கட்டுப்பாட்டையும் காட்டுகிறது
படி 2 — புதிய விசையை கடவுச்சொல் நிர்வாகி, சர்வர் பக்க ரகசியம் அல்லது பாதுகாப்பான Make/Zapier இணைப்பில் நகலெடுக்கவும். மூலக் குறியீடு, உலாவி பயன்பாடு அல்லது ஆதரவு டிக்கெட்டில் அதை ஒட்ட வேண்டாம்.

குறியீட்டுக்கு முன் எடுக்க வேண்டிய மூன்று முடிவுகள்

API விசை நோக்கம்

7stamp Admin இல் API Integrations → API KeysAdd API Key இன் கீழ் விசையை உருவாக்கவும். ஒரு சாவி ஒரு பணியிடத்திற்கு சொந்தமானது/profile, எனவே உங்கள் கணக்கு அமைப்பு அனுமதிக்கும் போது உருவாக்கம் மற்றும் உற்பத்திக்கான தனி விசைகளை உருவாக்கவும். ரகசியம் வெளிப்பட்டால் டாஷ்போர்டிலிருந்து அணுகலைச் சுழற்றவும் அல்லது திரும்பப் பெறவும்.

வாடிக்கையாளர் அடையாளம்

External ID என்பது உங்கள் கணினியிலிருந்து நிலையான தொடர்பு அடையாளங்காட்டியாகும்: ஒரு CRM ID, வாடிக்கையாளர் UUID, தொலைபேசி எண் அல்லது மின்னஞ்சல். ஒரு மாறாத அமைப்பு ID ஐ விரும்புக. அமைப்புகள் முழுவதும் மோதல்களைத் தவிர்க்கவும் மற்றும் வெப்ஹூக் தொடர்புகளை வெளிப்படையாக்கவும் விருப்பமாக External Source ஐச் சேர்க்கவும்.

டெம்ப்ளேட் தேர்வு

சுயவிவரம் செயலில் உள்ள டெம்ப்ளேட்டைக் கொண்டிருக்கும்போது, ​​template_id தவிர்க்கப்படலாம் மற்றும் 7stamp தானாகவே அதைத் தேர்ந்தெடுக்கும். இது பல செயலில் உள்ள டெம்ப்ளேட்களைக் கொண்டிருக்கும் போது, ​​உத்தேசித்துள்ள template_id ஐ அனுப்பவும். GET /templates ஐப் படிக்கவும், யூகிக்கப்பட்ட ID ஐ கடின குறியிடுவதை விட.

குறைந்தபட்ச அங்கீகரிக்கப்பட்ட கோரிக்கை: அழைப்பை உருவாக்கவும்

இதை உங்கள் ஆட்டோமேஷன் படியில் நகலெடுக்கவும் 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 விசையிலிருந்து முதல் வெற்றிகரமான கோரிக்கை வரை

01

7stamp Admin இல் உள்நுழைந்து ஒரு விசையை உருவாக்கவும்: API Integrations → API KeysAdd API Key. அதை உங்கள் ரகசிய மேலாளரில் சேமிக்கவும், மூலக் குறியீடு அல்லது கிளையன்ட் பக்க பயன்பாட்டில் அல்ல.

02

அடிப்படை URL ஐ https://api.7loc.com/cards-api என அமைத்து, Authorization: Bearer ஐச் சேர்க்கவும், அதைத் தொடர்ந்து ஒவ்வொரு சர்வர்-பக்கம் கோரிக்கைக்கான விசையையும் சேர்க்கவும்.

03

முதலில் GET /templates ஐ அழைக்கவும். வெற்றிகரமான பதில் டோக்கனை உறுதிப்படுத்துகிறது மற்றும் அந்த பணியிடத்தில் உள்ள டெம்ப்ளேட்களைக் காட்டுகிறது/profile.

04

உங்கள் சொந்த அமைப்பிலிருந்து நிலையான External ID மற்றும் விருப்பமான External Source ஐத் தேர்ந்தெடுக்கவும். உருவாக்குதல், ஸ்கேன் செய்தல், தேடுதல் மற்றும் வெப்ஹூக் லாஜிக் ஆகியவற்றில் அதே அடையாள ஜோடியைப் பயன்படுத்தவும்.

05

POST /cards/inviteஐ டிஸ்போசபிள் சோதனைத் தொடர்புடன் அழைக்கவும். உண்மையான வாடிக்கையாளர்களுக்கு டெலிவரியை தானியங்குபடுத்தும் முன் திரும்பிய நிறுவலை URL சரிபார்க்கவும்.

06

POST /cards/scan, வவுச்சர் அல்லது செய்திச் செயல்களைச் சேர்க்கவும், உள்நுழைவு, பிழை கையாளுதல் மற்றும் பாதுகாப்பான மறுபரிசீலனை /idempotency உத்தி ஆகியவற்றை உங்கள் சொந்த பின்தளத்தில் சேர்த்த பிறகுதான்.

ஒப்பந்தமாக API குறிப்பைப் பயன்படுத்தவும்

பொது 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 ஐ அனுப்பவும்.

template_id ஐ நான் எப்போது தவிர்க்கலாம்?

இணைக்கப்பட்ட சுயவிவரத்தில் சரியாக ஒரு கார்டு டெம்ப்ளேட் இருந்தால் மட்டுமே. பல டெம்ப்ளேட்டுகள் செயலில் இருந்தால், GET /templates. இலிருந்து சரியான template_id ஐத் தேர்ந்தெடுக்கவும்

நான் API, Make அல்லது Zapier ஐப் பயன்படுத்த வேண்டுமா?

தனிப்பயன் POS, பின்தளம், தளம் அல்லது முழுக் கட்டுப்பாட்டிற்கு API ஐப் பயன்படுத்தவும். காட்சிக் கிளைக் காட்சிகளுக்கு Make ஐப் பயன்படுத்தவும். பெரும்பாலும் நேரியல் தூண்டுதல்-செயல் பணிப்பாய்வுக்கு Zapier ஐப் பயன்படுத்தவும். மூன்றுமே ஒரே API விசையையும் API ஒப்பந்தத்தையும் சார்ந்துள்ளது.

அடுத்த படி

சிறிய பாதுகாப்பான API ஓட்டத்தை முதலில் சோதிக்கவும்

விசையை உருவாக்கவும், GET /templates ஐ அழைக்கவும், செலவழிக்கும் தொடர்புக்கான அழைப்பை உருவாக்கவும், பின்னர் நிரூபிக்கப்பட்ட கோரிக்கையைச் சுற்றி உற்பத்தி ரகசியங்கள், பதிவு செய்தல், மறு முயற்சிகள் மற்றும் வெப்ஹூக் கையாளுதல் ஆகியவற்றைச் சேர்க்கவும்.