Ujumuishaji wa msanidi

7stamp REST API

Inapatikana

7stamp Integration API huruhusu CRM, jukwaa la ecommerce, POS, mandhari maalum, au zana ya kiotomatiki kudhibiti kadi za uaminifu za pochi kwa kutumia kitambulisho cha mwasiliani ambacho mfumo wako tayari unatumia. Ni chaguo la ulimwengu wote wakati ujumuishaji maalum haupo.

Msingi wa API URL ni https://api.7loc.com/cards-api. Thibitisha kila ombi kwa kutumia kitufe cha API kama tokeni ya Bearer. Tumia rejeleo la OpenAPI lililounganishwa kwa taratibu za ombi la moja kwa moja na majibu kabla ya kuunda mantiki ya uzalishaji.

Unachoweza kufanya na API

API ni upande wa uandishi wa safu ya ujumuishaji. Itumie wakati wowote programu yako mwenyewe inapaswa kusalia chanzo cha uendeshaji cha ukweli huku 7stamp inashughulikia safu ya uaminifu ya pochi.

Toa kadi kutoka kwa programu yako mwenyewe

Tengeneza kiungo cha kadi ya pochi ya kibinafsi kwa mteja yeyote katika mfumo wako. Ifikishe kupitia barua pepe yako mwenyewe, SMS, kushinikiza, au mtiririko wa ndani ya programu. Mteja hufungua kiungo na kuhifadhi kadi kwenye Apple Wallet au Google Wallet.

Muhuri wa mkopo kutoka chanzo chochote

Ununuzi unapofungwa kwa desturi yako POS, agizo la mtandaoni linapolipwa kwenye tovuti yako, au huduma inapokamilika katika mfumo wako wa kuhifadhi, piga simu API ili utumie stempu za mikopo. Kadi inasasishwa ndani ya sekunde.

Dhibiti vocha na kampeni

Toa vocha ya mara moja kwa mteja mahususi, unda mtiririko wa zawadi ulio tayari kwa kampeni, na urejeshe hali ya vocha kwenye mifumo inayoshughulikia fedha na ubora wa huduma.

Ujumuishaji Uliohifadhiwa API shughuli

Hizi ni njia za umma API nyuma ya vitendo Make na Zapier. Soma mpangilio halisi katika rejeleo la API; usifikirie majina ya sehemu kutoka kwa ncha tofauti.

Kadi POST /cards/invite

Unda mwaliko wa kadi

Huunda usakinishaji mpya wa kibinafsi URL kwa anwani ya nje.

Kadi POST /cards/invite/bulk

Unda mialiko ya kadi nyingi

Huunda hadi viungo 100 vya kualika katika kundi linalodhibitiwa.

Kadi GET /cards

Tafuta kadi

Hutafuta rekodi za kadi kwa kutumia kitambulisho cha mwasiliani wa nje.

Kadi GET /cards/{user_card_id}

Pata maelezo ya kadi

Hurejesha hali kamili ya kadi moja kulingana na 7stamp ID.

Kadi POST /cards/scan

Changanua kadi

Huongeza stempu kwa kadi ID au External ID na hurekodi agizo la chanzo linapotolewa.

Violezo GET /templates

Violezo vya orodha

Huorodhesha violezo vya kadi vinavyopatikana mahali pa kazi pa ufunguo/profile.

Violezo GET /templates/{template_id}/design

Pata muundo wa kiolezo

Husoma mipangilio ya kuona ya kiolezo cha kadi inayojulikana.

Vocha POST /vouchers/issue

Toa vocha

Hutoa vocha kwa mwenye kadi.

Messages POST /messages/send

Tuma ujumbe

Hutuma kisukuma-kadi ya pochi na/or maudhui ya barua pepe kwa mwenye kadi.

Mahali pa kuunda na kunakili kitufe cha API

Hizi ni skrini 7stamp Admin halisi. Fungua API & Miunganisho, ongeza ufunguo, kisha uinakili kwenye muunganisho salama wa siri wa upande wa seva au otomatiki.

7stamp Admin API & Skrini ya Majumuisho inayoonyesha kitufe cha Add API Key na Unda API Kidirisha cha Ufunguo
Hatua ya 1 — Chagua 4⟧ Sehemu 4 usogezaji, fungua API Keys, chagua Add API Key, chagua kuingia kwa mfanyakazi kufaa, na uzalishe ufunguo.
7stamp Admin kidirisha kinachoonyesha ufunguo mpya API na udhibiti wake wa kunakili
Hatua ya 2 — Nakili ufunguo mpya kwenye kidhibiti cha nenosiri, siri ya upande wa seva, au salama Make53⟧53⟧5/14. Usiibandike kwenye msimbo wa chanzo, programu ya kivinjari, au tikiti ya usaidizi.

Maamuzi matatu ya kufanya kabla ya kusimba

API upeo wa ufunguo

Unda ufunguo katika 7stamp Admin chini ya API Integrations → API KeysAdd API Key. Ufunguo ni wa sehemu moja ya kazi/profile, kwa hivyo unda funguo tofauti za usanidi na uzalishaji wakati usanidi wa akaunti yako unaruhusu. Zungusha au ubatilishe ufikiaji kutoka kwa dashibodi ikiwa siri itafichuliwa.

Utambulisho wa mteja

External ID ndicho kitambulisho thabiti cha mwasiliani kutoka kwenye mfumo wako: CRM ID, mteja ⟦11375, au barua pepe, au barua pepe. Pendelea mfumo usiobadilika ID. Ongeza kwa hiari External Source ili kuepuka migongano katika mifumo yote na kufanya uunganisho wa webhook kuwa wazi.

Uchaguzi wa kiolezo

Wakati wasifu una kiolezo kimoja amilifu, template_id inaweza kuachwa na 7stamp kukichagua kiotomatiki. Inapokuwa na violezo vingi vinavyotumika, pitisha template_id iliyokusudiwa. Soma GET /templates kwanza badala ya kubashiri kwa bidii ID.

Ombi la chini kabisa lililothibitishwa: unda mwaliko

Nakili hii katika hatua yako ya kiotomatiki 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
  }'

Kutoka API ufunguo hadi ombi la kwanza lililofaulu

01

Ingia katika 7stamp Admin na uunde ufunguo: ⟦555. Ihifadhi kwenye kidhibiti chako cha siri, si msimbo wa chanzo au programu ya upande wa mteja.

02

Weka msingi URL hadi https://api.7loc.com/cards-api na uongeze Authorization: Bearer ikifuatiwa na ufunguo wa kila ombi la upande wa seva.

03

Piga simu GET /templates kwanza. Jibu lililofanikiwa huthibitisha tokeni na kuonyesha violezo vinavyopatikana mahali hapo pa kazi/profile.

04

Chagua External ID thabiti na hiari External Source kutoka kwa mfumo wako mwenyewe. Tumia jozi sawa za utambulisho katika kuunda, kuchanganua, kutafuta, na mantiki ya wavuti.

05

Piga simu POST /cards/invite ukitumia anwani ya majaribio inayoweza kutumika. Thibitisha usakinishaji uliorejeshwa URL kabla ya kuwasilisha kiotomatiki kwa wateja halisi.

06

Ongeza POST /cards/scan, vocha, au vitendo vya kutuma ujumbe baada tu ya kuwa na kumbukumbu, kushughulikia makosa na kujaribu tena kwa usalama/idempotency mkakati katika mazingira yako mwenyewe.

Tumia rejeleo la API kama mkataba

Rejeleo la Swagger/OpenAPI la umma lina mwisho wa sasa, kigezo, mwili wa ombi, majibu na miundo ya wavuti. URL mwingiliano ni https://api.7loc.com/cards-api/docs na mkataba unaosomeka kwa mashine ni https://api.7loc.com/cards-api/openapi.json. Ukisome kabla ya kutekeleza kushughulikia makosa au kuongeza sehemu za hiari.

Uthibitishaji na usalama muhimu

Ufunguo ni siri ya upande wa seva. Usiifichue katika JavaScript ya kivinjari, kifurushi cha programu ya simu, fomu ya umma, picha za skrini, Make/Zapier sehemu za maandishi, au tikiti za usaidizi. Tumia seva, muunganisho salama wa otomatiki, au kidhibiti cha siri. Ikiwa ufunguo utawahi kushirikiwa kimakosa, ubatilishe au uzungushe katika 7stamp Admin na usasishe muunganisho ulioathiriwa.

Maswali yanayoulizwa mara kwa mara

Nitapata wapi tokeni ya 7stamp API?

Katika 7stamp Admin, nenda kwa API Integrations → API Keys → Add API Key. Kisha ishara hutumwa kwa kichwa Authorization kama Bearer ikifuatiwa na ufunguo.

Msingi URL na njia ya uthibitishaji ni nini?

Tumia https://api.7loc.com/cards-api na utume Authorization: Bearer YOUR_7STAMP_API_KEY kwa kila ombi lililoidhinishwa.

Je, ni lini ninaweza kuacha template_id?

Wakati tu wasifu uliounganishwa una kiolezo kimoja cha kadi inayotumika. Ikiwa violezo vingi vinatumika, chagua sahihi template_id kutoka GET /templates.

Je, nitumie API, Make, au Zapier?

Tumia API kwa POS maalum, mazingira ya nyuma, tovuti, au udhibiti kamili. Tumia Make kwa matukio ya matawi yanayoonekana. Tumia Zapier kwa mtiririko wa vitendo wa kichochezi. Wote watatu wanategemea API ufunguo sawa na mkataba API.

Hatua inayofuata

Jaribu salama ndogo zaidi API mtiririko kwanza

Unda ufunguo, piga simu kwa GET /templates, unda mwaliko mmoja kwa anwani inayoweza kutumika, kisha uongeze siri za uzalishaji, kumbukumbu, kujaribu tena na kushughulikia ombi lililothibitishwa.