7stamp λειτουργίες για κλήση από το Make HTTP
Για κάθε κάρτα παρακάτω, προσθέστε HTTP → Make a request, μετά ορίστε τη μέθοδο και URL ακριβώς όπως φαίνεται. Χρησιμοποιήστε το ίδιο κλειδί Bearer για κάθε αίτημα. Η απαιτούμενη αντιστοίχιση σάς λέει τι να παρέχετε από τον κανόνα CRM, POS ή το έναυσμα ηλεκτρονικού εμπορίου.
Έναυσμα Make Webhooks → Custom webhook
Λήψη εκδήλωσης κάρτας
Δημιουργήστε ένα Custom webhook στο Make, αντιγράψτε το URL και, στη συνέχεια, επικολλήστε τις ρυθμίσεις URL στο προφίλ ⟦2435 ok Αυτό ξεκινά ένα σενάριο όταν το 7stamp στέλνει ένα συμβάν όπως SCAN, REWARD_EARNED ή VOUCHER_ISSUED.
- Σε Make
- Webhooks → Custom webhook → Προσθήκη; δώστε του ένα σαφές όνομα και αντιγράψτε το URL που δημιουργήθηκε.
- Σε 7stamp
- Διαχειριστής → API & Integrations → Webhooks; επικολλήστε το URL, επιλέξτε τύπους συμβάντων, αποθηκεύστε και, στη συνέχεια, δημιουργήστε ένα δοκιμαστικό συμβάν.
HTTP POST /cards/invite
Δημιουργήστε μια ενέργεια Card Invite
Δημιουργήστε μια νέα προσωπική εγκατάσταση URL και εισαγάγετε κωδικό παράδοσης για μία εξωτερική επαφή.
- Απαιτείται
- external_id — αντιστοιχίστε τον στάβλο σας CRM/contact ID, όχι όνομα.
- Στη συνέχεια χρησιμοποιήστε το
- Χάρτη install_url από την απάντηση στο email σας, SMS ή CRM βήμα ενημέρωσης.
HTTP ενέργεια POST /cards/invite/bulk
Μαζική δημιουργία Card Invites
Δημιουργεί έως και 100 συνδέσμους πρόσκλησης σε ένα αίτημα. Χρησιμοποιήστε το για ελεγχόμενη μετεγκατάσταση ή καμπάνια, όχι για απεριόριστη εξαγωγή επαφών.
- Απαιτούμενα
- στοιχεία — ένας πίνακας JSON από 1–100 μεμονωμένα αντικείμενα αιτήματος πρόσκλησης.
- Ελέγξτε
- Διαβάστε τα success_count, error_count και κάθε αποτέλεσμα πριν στείλετε τυχόν συνδέσμους.
HTTP ενέργεια GET /cards
Find Cards
Βρίσκει εγγραφές καρτών κατά External ID, με προαιρετικό πρότυπο και φίλτρα πηγής.
- Απαιτείται
- Παράμετρος ερωτήματος external_id.
- Προαιρετικά
- external_source και template_id περιορίζουν την αναζήτηση όταν ένα σύστημα έχει πολλά προγράμματα.
Ενέργεια HTTP GET /cards/{user_card_id}
Λάβετε Στοιχεία Κάρτας
Διαβάζει την πλήρη κατάσταση μιας κάρτας όταν ένα προηγούμενο βήμα έχει επιστρέψει το εσωτερικό του User Card ID.
- Απαιτείται
- Αντικαταστήστε το {user_card_id} με το εσωτερικό ID που επιστράφηκε από μια αξιόπιστη απάντηση 7stamp.
- Αποφύγετε
- Μην μαντεύετε ή αποθηκεύετε μια κάρτα ID από διαφορετικό προφίλ.
HTTP ενέργεια POST /cards/scan
Σάρωση κάρτας
Προσθέτει γραμματόσημα από ένα ποσό αγοράς ή μια ρητή καταμέτρηση. Αποδέχεται User Card ID ή External ID και μπορεί να διατηρήσει την εξωτερική αναφορά παραγγελίας.
- Ταυτότητα
- Χρήση external_id και προαιρετικό external_source; Το user_card_id κερδίζει εάν παρέχονται και τα δύο.
- Αγορά
- Χρησιμοποιήστε το ποσό για κάρτες βάσει ποσού ή stamps_count για έναν ρητό αριθμό. Το stamps_count έχει προτεραιότητα.
- Ιχνηλασιμότητα
- Χάρτης external_order_id από την πληρωμένη παραγγελία/receipt ώστε να μπορούν να αντιστοιχιστούν συμβάντα 7stamp.
HTTP ενέργεια GET /templates
List Templates
Εμφανίζει τα πρότυπα καρτών που είναι διαθέσιμα στο κλειδί API. Χρησιμοποιήστε το για να δοκιμάσετε τη σύνδεση ή να επιλέξετε ένα πρότυπο δυναμικά.
- Πρώτη δοκιμή
- Αυτό είναι το πιο ασφαλές πρώτο αίτημα: δεν έχει σώμα και δεν αλλάζει τα δεδομένα πελατών.
- Χάρτη αργότερα
- Χρησιμοποιήστε το αναγνωριστικό ενός ενεργού προτύπου ως template_id μόνο όταν το προφίλ έχει περισσότερα από ένα ενεργά πρότυπα.
HTTP ενέργεια GET /templates/{template_id}/design
Get Template Design
Επιστρέφει τις ρυθμίσεις οπτικού σχεδιασμού για ένα γνωστό πρότυπο, χρήσιμο όταν ένα άλλο σύστημα χρειάζεται να εμφανίσει μια συνεπή επιλογή κάρτας.
HTTP ενέργεια POST /vouchers/issue
Έκδοση κουπονιού
Εκδίδει κουπόνι σε κάτοχο κάρτας που προσδιορίζεται από External ID ή ⟦24413⟦
- Απαιτείται κουπόνι
- .short_description. Στοχεύστε την κάρτα με external_id ή ένα γνωστό user_card_id.
- Εγκυρότητα
- Χρησιμοποιήστε το validity_type με validity_value ή διαβάστε την αναφορά OpenAPI για μια σταθερή ημερομηνία λήξης.
HTTP ενέργεια POST /messages/send
Αποστολή μηνύματος
Στέλνει περιεχόμενο στον κάτοχο της κάρτας μέσω push wallet-card και/or email, σύμφωνα με τους διαμορφωμένους κανόνες καναλιού και συναίνεσης. Το
- Η προώθηση κάρτας
- card_push_text περιορίζεται σε 20 χαρακτήρες και απαιτεί εγκατεστημένο πάσο πορτοφολιού.
- Email
- Αποστολή θέματος συν το σώμα. Το βασικό HTML υποστηρίζεται στο σώμα.
Make μονάδα Full 7stamp endpoint URL
HTTP → Make a request
Αυτή είναι η ενότητα Make που καλεί κάθε 7stamp διαδρομή. Χρησιμοποιήστε ένα πλήρες URL, επιλέξτε την τεκμηριωμένη μέθοδο, προσθέστε την κεφαλίδα Bearer και χρησιμοποιήστε JSON μόνο όταν η διαδρομή χρειάζεται σώμα.
- Βάση URL
- https://api.7loc.com/cards-api
- Επικεφαλίδα
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json για POST αιτήματα.