Մշակողի ինտեգրում
7stamp Integration API-ը թույլ է տալիս CRM-ին, էլեկտրոնային առևտրի հարթակին, POS-ին, մաքսային հետնամասին կամ ավտոմատացման գործիքին կառավարել դրամապանակի հավատարմության քարտերը ձեր սեփական համակարգի կողմից արդեն իսկ օգտագործվող կոնտակտային նույնացուցիչով: Դա ունիվերսալ տարբերակ է, երբ չկա մասնագիտացված ինտեգրում:
API բազան URL է https://api.7loc.com/cards-api.. Նույնականացրեք յուրաքանչյուր հարցումը API բանալիով որպես Bearer նշան: Օգտագործեք կապակցված OpenAPI հղումը կենդանի հարցումների և պատասխանների սխեմաների համար, նախքան արտադրության տրամաբանությունը կառուցելը:
API-ը ինտեգրման կույտի գրման կողմն է: Օգտագործեք այն ամեն անգամ, երբ ձեր սեփական ծրագրաշարը պետք է մնա ճշմարտության գործառնական աղբյուրը, մինչդեռ 7stamp-ը մշակում է դրամապանակի հավատարմության շերտը:
Ստեղծեք անձնական դրամապանակի քարտի հղում ձեր համակարգի ցանկացած հաճախորդի համար: Առաքեք այն ձեր սեփական էլ.փոստի, SMS, push կամ հավելվածի միջոցով: Հաճախորդը բացում է հղումը և պահում քարտը Apple Wallet կամ Google Wallet:
Երբ գնումը ավարտվում է ձեր հատուկ POS-ում, երբ առցանց պատվերը վճարվում է ձեր կայքում, կամ երբ ծառայությունն ավարտվում է ձեր ամրագրման համակարգում, զանգահարեք API վարկային նամականիշերին: Քարտը թարմացվում է վայրկյանների ընթացքում:
Տրամադրեք միանվագ վաուչեր կոնկրետ հաճախորդին, ստեղծեք արշավին պատրաստ պարգևների հոսքեր և վերադարձրեք վաուչերի կարգավիճակը ֆինանսական և ծառայությունների որակը կարգավորող համակարգեր:
Սրանք հանրային API երթուղիներն են Make6-ի և Make6 գործողության հետևում: Կարդացեք ճշգրիտ սխեման 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 & Integrations, ավելացրեք բանալի, այնուհետև պատճենեք այն անվտանգ սերվերի կողմից գաղտնի կամ ավտոմատացման միացման մեջ:
Ստեղծեք բանալին 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
}'Մուտք գործեք 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 յուրաքանչյուր լիազորված հարցումով:
Միայն այն դեպքում, երբ միացված պրոֆիլն ունի ուղիղ մեկ ակտիվ քարտի ձևանմուշ: Եթե մի քանի ձևանմուշներ ակտիվ են, ընտրեք ճիշտ template_id GET /templates.-ից
Օգտագործեք API-ը հատուկ POS-ի, հետնամասի, կայքի կամ ամբողջական վերահսկողության համար: Օգտագործեք Make վիզուալ ճյուղավորման սցենարների համար: Օգտագործեք Zapier հիմնականում գծային ձգանման գործողությունների աշխատանքային հոսքի համար: Երեքն էլ ապավինում են նույն API բանալիին և API պայմանագրին:
Հաջորդ քայլը
Ստեղծեք բանալին, զանգահարեք GET /templates, ստեղծեք մեկ հրավեր միանգամյա օգտագործման կոնտակտի համար, այնուհետև ավելացրեք արտադրության գաղտնիքները, գրանցումը, կրկնվող փորձերը և վեբ-կապիկի մշակումը ապացուցված հարցման շուրջ: