ಡೆವಲಪರ್ ಏಕೀಕರಣ
7stamp Integration API CRM, ಇಕಾಮರ್ಸ್ ಪ್ಲಾಟ್ಫಾರ್ಮ್, POS, ಕಸ್ಟಮ್ ಬ್ಯಾಕೆಂಡ್ ಅಥವಾ ಆಟೊಮೇಷನ್ ಟೂಲ್ ನಿಮ್ಮ ಸ್ವಂತ ಸಿಸ್ಟಂ ಈಗಾಗಲೇ ಬಳಸುತ್ತಿರುವ ಕಾಂಟ್ಯಾಕ್ಟ್ ಐಡೆಂಟಿಫೈಯರ್ನೊಂದಿಗೆ ವ್ಯಾಲೆಟ್ ಲಾಯಲ್ಟಿ ಕಾರ್ಡ್ಗಳನ್ನು ನಿರ್ವಹಿಸಲು ಅನುಮತಿಸುತ್ತದೆ. ವಿಶೇಷ ಏಕೀಕರಣವು ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲದಿದ್ದಾಗ ಇದು ಸಾರ್ವತ್ರಿಕ ಆಯ್ಕೆಯಾಗಿದೆ.
API ಬೇಸ್ URL https://api.7loc.com/cards-api. ಪ್ರತಿ ವಿನಂತಿಯನ್ನು API ಕೀಲಿಯೊಂದಿಗೆ Bearer ಟೋಕನ್ ಆಗಿ ಪ್ರಮಾಣೀಕರಿಸಿ. ಉತ್ಪಾದನಾ ತರ್ಕವನ್ನು ನಿರ್ಮಿಸುವ ಮೊದಲು ಲೈವ್ ವಿನಂತಿ ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಕೀಮಾಗಳಿಗಾಗಿ ಲಿಂಕ್ ಮಾಡಲಾದ 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 ಕರೆ ಮಾಡಿ, ಬಿಸಾಡಬಹುದಾದ ಸಂಪರ್ಕಕ್ಕಾಗಿ ಒಂದು ಆಹ್ವಾನವನ್ನು ರಚಿಸಿ, ನಂತರ ಸಾಬೀತಾದ ವಿನಂತಿಯ ಸುತ್ತ ಉತ್ಪಾದನಾ ರಹಸ್ಯಗಳು, ಲಾಗಿಂಗ್, ಮರುಪ್ರಯತ್ನಗಳು ಮತ್ತು ವೆಬ್ಹೂಕ್ ನಿರ್ವಹಣೆಯನ್ನು ಸೇರಿಸಿ.