7stamp mga operasyon na tatawagan mula sa Make HTTP
Para sa bawat card sa ibaba, idagdag ang HTTP → Make a request, pagkatapos ay itakda ang paraan at URL eksakto tulad ng ipinapakita. Gamitin ang parehong Bearer key para sa bawat kahilingan. Sinasabi sa iyo ng kinakailangang pagmamapa kung ano ang ibibigay mula sa iyong CRM, POS, o trigger ng ecommerce.
Make trigger Webhooks → Custom webhook
Makatanggap ng card event
Gumawa ng Custom webhook sa Make, kopyahin ang URL nito, pagkatapos ay i-paste iyon URL sa 7stamp na mga setting ng profile Nagsisimula ito ng senaryo kapag nagpadala ang 7stamp ng kaganapan gaya ng SCAN, REWARD_EARNED, o VOUCHER_ISSUED.
- Sa Make
- Webhooks → Custom webhook → Idagdag; bigyan ito ng malinaw na pangalan at kopyahin ang nabuong URL.
- Sa 7stamp
- Admin → API & Integrations → Webhooks; i-paste ang URL, piliin ang mga uri ng kaganapan, i-save, pagkatapos ay gumawa ng pansubok na kaganapan.
HTTP aksyon POST /cards/invite
Lumikha ng Card Invite
Lumilikha ng bagong personal na pag-install URL at delivery-insert code para sa isang external na contact.
- Kinakailangan
- external_id — imapa ang iyong kuwadra CRM/contact ID, hindi pangalan.
- Pagkatapos ay gamitin ang
- Map install_url mula sa tugon sa iyong email, SMS, o CRM hakbang sa pag-update.
HTTP aksyon POST /cards/invite/bulk
Bultuhang Gumawa Card Invites
Lumilikha ng hanggang 100 link ng imbitasyon sa isang kahilingan. Gamitin ito para sa isang kinokontrol na paglipat o kampanya, hindi isang walang limitasyong pag-export ng contact.
- Kinakailangan
- item — isang JSON hanay ng 1–100 indibidwal na object ng kahilingan sa pag-imbita.
- Suriin ang
- Basahin ang success_count, error_count, at bawat resulta bago magpadala ng anumang mga link.
HTTP aksyon GET /cards
Find Cards
Naghahanap ng mga tala ng card sa pamamagitan ng External ID, na may opsyonal na template at source filter.
- Kinakailangan
- Parameter ng query external_id.
- Opsyonal
- external_source at template_id paliitin ang lookup kapag ang isang system ay may maraming mga programa.
HTTP aksyon GET /cards/{user_card_id}
Kumuha ng Detalye ng Card
Binabasa ang buong estado ng isang card kapag naibalik ng naunang hakbang ang panloob na User Card ID.
- Kinakailangan
- Palitan ang {user_card_id} ng panloob na ID na ibinalik ng mapagkakatiwalaang 7stamp na tugon.
- Iwasan ang
- Huwag hulaan o iimbak ang isang card ID mula sa ibang profile.
HTTP aksyon POST /cards/scan
Mag-scan ng Card
Nagdaragdag ng mga selyo mula sa halagang binili o tahasang bilang. Tumatanggap ito ng User Card ID o External ID at maaaring panatilihin ang panlabas na sanggunian ng order.
- Pagkakakilanlan
- Gamitin ang external_id at opsyonal external_source; user_card_id mananalo kung pareho ang ibinibigay.
- Bumili
- Gumamit ng halaga para sa mga card na nakabatay sa halaga o stamps_count para sa isang tahasang numero; stamps_count ang priyoridad.
- Kakayahang masubaybayan
- Mapa external_order_id mula sa bayad na order/receipt kaya 7stamp kaganapan ay maaaring itugma pabalik.
HTTP aksyon GET /templates
List Templates
Naglilista ng mga template ng card na available sa API key. Gamitin ito upang subukan ang koneksyon o upang dynamic na pumili ng template.
- Unang pagsubok
- Ito ang pinakaligtas na unang kahilingan: wala itong katawan at hindi binabago ang data ng customer.
- Mapa mamaya
- Gamitin ang isang aktibong template ng id bilang template_id lamang kapag ang profile ay may higit sa isang aktibong template.
HTTP aksyon GET /templates/{template_id}/design
Get Template Design
Ibinabalik ang mga setting ng visual na disenyo para sa isang kilalang template, na kapaki-pakinabang kapag kailangan ng ibang system na magpakita ng pare-parehong pagpipilian sa card.
HTTP aksyon POST /vouchers/issue
Mag-isyu ng Voucher
Mag-isyu ng voucher sa may-ari ng card na kinilala ng External ID o User Card ID.
- Kinakailangan
- voucher.short_description. I-target ang card gamit ang external_id o isang kilalang user_card_id.
- Validity
- Gamitin ang validity_type na may validity_value, o basahin ang OpenAPI reference para sa isang nakapirming petsa ng pag-expire.
HTTP aksyon POST /messages/send
Magpadala ng Mensahe
Nagpapadala ng content sa may-ari ng card sa pamamagitan ng wallet-card push at/or email, na napapailalim sa na-configure na channel at mga panuntunan sa pahintulot.
- Card push
- card_push_text ay limitado sa 20 character at nangangailangan ng naka-install na wallet pass.
- Email
- Ipadala ang paksa at katawan; ang basic HTML ay sinusuportahan sa katawan.
Make module Full 7stamp endpoint URL
HTTP → Make a request
Ito ang Make module na tumatawag sa bawat 7stamp na ruta. Gumamit ng kumpletong URL, piliin ang nakadokumentong paraan, idagdag ang Bearer header, at gamitin lang ang JSON kapag ang ruta ay nangangailangan ng katawan.
- Base URL
- https://api.7loc.com/cards-api
- Header
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json para sa POST mga kahilingan.