Интеграција програмера
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 да бисте кредитирали маркице. Картица се ажурира у року од неколико секунди.
Издајте једнократни ваучер одређеном купцу, креирајте токове награда спремних за кампању и вратите статус ваучера у системе који управљају финансијама и квалитетом услуга.
Ово су јавне руте API иза акција Make и Zapier. Прочитајте тачну шему у референци 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 Прочитајте визуелне шаблоне99⟦999999⟟ подешавања за познати шаблон картице.
POST /vouchers/issue Издаје ваучер власнику картице.
POST /messages/send Шаље садржај картице новчаника и/or е-поште власнику картице.
Ово су прави екрани 7stamp Admin. Отворите 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 уместо да чврсто кодирате нагађани 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
}'Sign in to 7stamp Admin and create a key: API Integrations → API Keys → Add API Key. Store it in your secret manager, not source code or a client-side application.
Поставите базу 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. Прочитајте га пре имплементације руковања грешкама или додавања опционих поља.
Кључ је тајна на страни сервера. Немојте га излагати у ЈаваСцрипт-у претраживача, пакету мобилних апликација, јавном обрасцу, снимцима екрана, 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_КЕИ на сваки овлашћени захтев.
Само када повезани профил има тачно један активни шаблон картице. Ако је активно више шаблона, изаберите исправан template_id од GET /templates.
Користите API за прилагођени POS, позадину, локацију или потпуну контролу. Користите Make за сценарије визуелног гранања. Користите Zapier за углавном линеарни радни ток окидача. Сва три се ослањају на исти API кључ и API уговор.
Повезане странице
Следећи корак
Креирајте кључ, позовите GET /templates, креирајте једну позивницу за контакт за једнократну употребу, а затим додајте тајне производње, евидентирање, поновне покушаје и руковање веб-хуком око доказаног захтева.