Pagsasama ng developer
Ang 7stamp Integration API ay nagbibigay-daan sa isang CRM, ecommerce platform, POS, custom na backend, o automation tool na pamahalaan ang mga wallet loyalty card gamit ang contact identifier na ginagamit na ng sarili mong system. Ito ang unibersal na opsyon kapag ang isang dalubhasang pagsasama ay walang umiiral.
Ang API base URL ay https://api.7loc.com/cards-api. I-authenticate ang bawat kahilingan gamit ang API key bilang Bearer token. Gamitin ang naka-link na OpenAPI reference para sa live na kahilingan at mga schema ng pagtugon bago bumuo ng lohika ng produksyon.
Ang API ay ang write side ng integration stack. Gamitin ito sa tuwing ang iyong sariling software ay dapat manatili sa pagpapatakbong pinagmumulan ng katotohanan habang pinangangasiwaan ng 7stamp ang wallet loyalty layer.
Bumuo ng link ng personal na wallet card para sa sinumang customer sa iyong system. Ihatid ito sa pamamagitan ng sarili mong email, SMS, push, o in-app na daloy. Binuksan ng customer ang link at ise-save ang card sa Apple Wallet o Google Wallet.
Kapag ang isang pagbili ay nagsara sa iyong custom na POS, kapag ang isang online na order ay binayaran sa iyong website, o kapag ang isang serbisyo ay nakumpleto sa iyong booking system, tawagan ang API sa mga credit stamp. Nag-a-update ang card sa loob ng ilang segundo.
Mag-isyu ng one-off na voucher sa isang partikular na customer, gumawa ng mga daloy ng reward na handa sa kampanya, at ibalik ang status ng voucher sa mga system na humahawak sa pananalapi at kalidad ng serbisyo.
Ito ang mga pampublikong API ruta sa likod ng Make at Zapier na mga aksyon. Basahin ang eksaktong schema sa API reference; huwag maghinuha ng mga pangalan ng field mula sa ibang endpoint.
POST /cards/invite Gumagawa ng bagong personal na pag-install URL para sa isang panlabas na contact.
POST /cards/invite/bulk Lumilikha ng hanggang 100 link ng imbitasyon sa isang kinokontrol na batch.
GET /cards Hinahanap ang mga tala ng card sa pamamagitan ng external na contact identifier.
GET /cards/{user_card_id} Ibinabalik ang buong estado ng isang card sa pamamagitan ng panloob na 7stamp ID.
POST /cards/scan Nagdaragdag ng mga selyo sa pamamagitan ng card ID o External ID at itinatala ang source order kapag ibinigay.
GET /templates Naglilista ng mga template ng card na available sa lugar ng trabaho ng susi/profile.
GET /templates/{template_id}/design Nagbabasa ng mga visual na setting para sa isang kilalang template ng card.
POST /vouchers/issue Nagbibigay ng voucher sa isang may-ari ng card.
POST /messages/send Nagpapadala ng wallet-card push at/or email na nilalaman sa isang may-ari ng card.
Ito ay mga tunay na 7stamp Admin na screen. Buksan ang API & Integrations, magdagdag ng key, pagkatapos ay kopyahin ito sa isang secure na server-side secret o automation na koneksyon.
Gawin ang susi sa 7stamp Admin sa ilalim ng API Integrations → API Keys → Add API Key. Ang isang susi ay pag-aari sa isang lugar ng trabaho/profile, kaya gumawa ng hiwalay na mga susi para sa pag-unlad at produksyon kapag pinapayagan ito ng iyong pag-setup ng account. I-rotate o bawiin ang access mula sa dashboard kung may nalantad na lihim.
Ang External ID ay ang stable na contact identifier mula sa iyong system: isang CRM ID, customer UUID, numero ng telepono, o email. Mas gusto ang isang hindi nababagong sistema ID. Opsyonal na idagdag ang External Source upang maiwasan ang mga banggaan sa mga system at upang gawing tahasan ang ugnayan ng webhook.
Kapag ang profile ay may isang aktibong template, template_id maaaring tanggalin at 7stamp ito ay awtomatikong pipiliin. Kapag marami itong aktibong template, ipasa ang nilalayong template_id. Basahin muna ang GET /templates sa halip na mag-hard-coding ng nahulaan na 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
}'Mag-sign in sa 7stamp Admin at gumawa ng susi: ⟦10499. I-store ito sa iyong secret manager, hindi source code o isang client-side application.
Itakda ang base URL sa https://api.7loc.com/cards-api at idagdag ang Authorization: Bearer na sinusundan ng susi sa bawat kahilingan sa panig ng server.
Tawagan muna ang GET /templates. Kinukumpirma ng matagumpay na tugon ang token at ipinapakita ang mga template na available sa lugar ng trabahong iyon/profile.
Piliin ang stable External ID at opsyonal External Source mula sa sarili mong system. Gamitin ang eksaktong parehong pares ng pagkakakilanlan sa paglikha, pag-scan, paghahanap, at lohika ng webhook.
Tumawag sa POST /cards/invite gamit ang disposable test contact. I-verify ang ibinalik na pag-install URL bago i-automate ang paghahatid sa mga tunay na customer.
Magdagdag lamang ng POST /cards/scan, voucher, o mga aksyon sa mensahe pagkatapos mong mag-log, paghawak ng error, at ligtas na muling subukang/idempotency na diskarte sa sarili mong backend.
Ang pampublikong Swagger/OpenAPI reference ay naglalaman ng kasalukuyang endpoint, parameter, request-body, tugon, at webhook schemas. Ang interactive na URL ay https://api.7loc.com/cards-api/docs at ang machine-readable na kontrata ay https://api.7loc.com/cards-api/openapi.json. Basahin ito bago ipatupad ang paghawak ng error o magdagdag ng mga opsyonal na field.
Ang susi ay isang lihim sa panig ng server. Huwag ilantad ito sa browser JavaScript, isang mobile app bundle, isang pampublikong form, mga screenshot, Make/Zapier text field, o support ticket. Gumamit ng server, secure na koneksyon sa automation, o secret manager. Kung hindi sinasadyang naibahagi ang susi, bawiin o i-rotate ito sa 7stamp Admin at i-update ang apektadong koneksyon.
Sa 7stamp Admin, pumunta sa API Integrations → API Keys → Add API Key. Ang token ay ipapadala sa Authorization header bilang Bearer na sinusundan ng susi.
Gamitin ang https://api.7loc.com/cards-api at ipadala ang Authorization: Bearer YOUR_7STAMP_API_KEY sa bawat awtorisadong kahilingan.
Lamang kapag ang konektadong profile ay may eksaktong isang aktibong template ng card. Kung maraming template ang aktibo, piliin ang tamang template_id mula sa GET /templates.
Gamitin ang API para sa custom na POS, backend, site, o ganap na kontrol. Gamitin ang Make para sa mga visual branching na sitwasyon. Gamitin ang Zapier para sa halos linear na trigger-action na daloy ng trabaho. Ang tatlo ay umaasa sa parehong API susi at API kontrata.
Mga kaugnay na pahina
Susunod na hakbang
Lumikha ng susi, tumawag sa GET /templates, gumawa ng isang imbitasyon para sa isang disposable contact, pagkatapos ay magdagdag ng mga lihim ng produksyon, pag-log, muling pagsubok, at pangangasiwa sa webhook tungkol sa napatunayang kahilingan.