ഡെവലപ്പർ ഇൻ്റഗ്രേഷൻ
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: a 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 എന്ന് വിളിക്കുക, ഡിസ്പോസിബിൾ കോൺടാക്റ്റിനായി ഒരു ക്ഷണം സൃഷ്ടിക്കുക, തുടർന്ന് തെളിയിക്കപ്പെട്ട അഭ്യർത്ഥനയ്ക്ക് ചുറ്റും പ്രൊഡക്ഷൻ രഹസ്യങ്ങൾ, ലോഗിംഗ്, വീണ്ടും ശ്രമിക്കൽ, വെബ്ഹുക്ക് കൈകാര്യം ചെയ്യൽ എന്നിവ ചേർക്കുക.