Әзірлеушілерді біріктіру
7stamp Integration API CRM, электрондық коммерция платформасы, POS, пайдаланушы сервері немесе автоматтандыру құралы жеке жүйеңіз бұрыннан қолданатын контакт идентификаторы бар әмиянның адалдық карталарын басқаруға мүмкіндік береді. Мамандандырылған интеграция болмаған кезде бұл әмбебап нұсқа.
API негізі URL — https://api.7loc.com/cards-api. әрбір сұрауды Bearer белгісі ретінде API кілтімен аутентификациялаңыз. Өндіріс логикасын құру алдында тікелей сұрау және жауап схемалары үшін байланыстырылған OpenAPI анықтамасын пайдаланыңыз.
API - біріктіру стекінің жазу жағы. 7stamp әмиянның адалдық деңгейін өңдеген кезде жеке бағдарламалық құрал шындықтың операциялық көзі болып қалатын кезде оны пайдаланыңыз.
Жүйедегі кез келген тұтынушы үшін жеке әмиян картасының сілтемесін жасаңыз. Оны жеке электрондық пошта, SMS, push немесе қолданбадағы ағын арқылы жеткізіңіз. Тұтынушы сілтемені ашып, картаны 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 Карта иесіне әмиян картасын push және/or электрондық пошта мазмұнын жібереді.
Бұл нағыз 7stamp Admin экрандар. API & Integrations қолданбасын ашыңыз, кілт қосыңыз, содан кейін оны қауіпсіз серверлік құпияға немесе автоматтандыру қосылымына көшіріңіз.
7stamp Admin ішінде API Integrations → API Keys → Add API Key астында кілт жасаңыз. Кілт бір жұмыс орнына тиесілі/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 тексеріңіз.
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 нөміріне қоңырау шалыңыз, бір реттік контактіге бір шақыру жасаңыз, содан кейін дәлелденген сұрау айналасында өндірістік құпияларды, журналды тіркеуді, қайталауды және веб-хукты өңдеуді қосыңыз.