Ενσωμάτωση προγραμματιστή
Το 7stamp Integration API επιτρέπει σε ένα CRM, πλατφόρμα ηλεκτρονικού εμπορίου, POS, προσαρμοσμένο backend ή εργαλείο αυτοματισμού να διαχειρίζεται κάρτες αφοσίωσης πορτοφολιού με το αναγνωριστικό επαφής που χρησιμοποιεί ήδη το δικό σας σύστημα. Είναι η καθολική επιλογή όταν δεν υπάρχει εξειδικευμένη ενσωμάτωση.
Η βάση API URL είναι https://api.7loc.com/cards-api. Επαληθεύστε κάθε αίτημα με ένα κλειδί API ως διακριτικό Bearer. Χρησιμοποιήστε τη συνδεδεμένη αναφορά OpenAPI για τα ζωντανά σχήματα αιτημάτων και απόκρισης πριν δημιουργήσετε τη λογική παραγωγής.
Το API είναι η πλευρά εγγραφής της στοίβας ενοποίησης. Χρησιμοποιήστε το όποτε το δικό σας λογισμικό παραμένει η λειτουργική πηγή της αλήθειας, ενώ το 7stamp χειρίζεται το επίπεδο αφοσίωσης του πορτοφολιού.
Δημιουργήστε έναν σύνδεσμο προσωπικής κάρτας πορτοφολιού για οποιονδήποτε πελάτη στο σύστημά σας. Παραδώστε το μέσω του δικού σας email, SMS, push ή ροής εντός εφαρμογής. Ο πελάτης ανοίγει τον σύνδεσμο και αποθηκεύει την κάρτα στο Apple Wallet ή στο Google Wallet.
Όταν μια αγορά κλείνει στο προσαρμοσμένο σας POS, όταν πληρώνεται μια ηλεκτρονική παραγγελία στον ιστότοπό σας ή όταν ολοκληρωθεί μια υπηρεσία στο σύστημα κρατήσεών σας, καλέστε το API για να πιστώσετε τα γραμματόσημα. Η κάρτα ενημερώνεται μέσα σε δευτερόλεπτα.
Εκδώστε ένα εφάπαξ κουπόνι σε έναν συγκεκριμένο πελάτη, δημιουργήστε ροές ανταμοιβής έτοιμες για καμπάνια και επαναφέρετε την κατάσταση κουπονιών στα συστήματα που χειρίζονται τα οικονομικά και την ποιότητα των υπηρεσιών.
Αυτές είναι οι δημόσιες διαδρομές API πίσω από τις ενέργειες Make και Zapier. Διαβάστε το ακριβές σχήμα στην αναφορά 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 Αποστέλλει περιεχόμενο email-card push και/or σε έναν κάτοχο κάρτας.
Αυτές είναι πραγματικές οθόνες 7stamp Admin. Ανοίξτε το API & Integrations, προσθέστε ένα κλειδί και, στη συνέχεια, αντιγράψτε το σε μια ασφαλή μυστική σύνδεση ή σύνδεση αυτοματισμού από την πλευρά του διακομιστή.
Δημιουργήστε το κλειδί στο 7stamp Admin κάτω από το API Integrations → API Keys → Add API Key. Ένα κλειδί ανήκει σε ένα χώρο εργασίας/profile, επομένως δημιουργήστε ξεχωριστά κλειδιά για ανάπτυξη και παραγωγή όταν το επιτρέπει η ρύθμιση του λογαριασμού σας. Περιστρέψτε ή ανακαλέστε την πρόσβαση από τον πίνακα εργαλείων εάν αποκαλυφθεί κάποιο μυστικό. Το
External ID είναι το σταθερό αναγνωριστικό επαφής από το σύστημά σας: ένα CRM ID, πελάτης UUID ή email, αριθμός τηλεφώνου, Προτιμήστε ένα αμετάβλητο σύστημα ID. Προαιρετικά, προσθέστε External Source για να αποφύγετε συγκρούσεις μεταξύ συστημάτων και για να καταστήσετε σαφή τη συσχέτιση webhook.
Όταν το προφίλ έχει ένα ενεργό πρότυπο, το 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
}'Sign in to 7stamp Admin and create a key: API Integrations → API Keys → Add API Key. Store it in your secret manager, not source code or a client-side application.
Ορίστε τη βάση URL σε https://api.7loc.com/cards-api και προσθέστε Authorization: Bearer ακολουθούμενο από το κλειδί σε κάθε αίτημα από την πλευρά του διακομιστή.
Καλέστε πρώτα στο GET /templates. Μια επιτυχημένη απάντηση επιβεβαιώνει το διακριτικό και εμφανίζει τα πρότυπα που είναι διαθέσιμα σε αυτόν τον χώρο εργασίας/profile.
Επιλέξτε το σταθερό External ID και το προαιρετικό External Source από το δικό σας σύστημα. Χρησιμοποιήστε το ίδιο ακριβώς ζεύγος ταυτότητας στη λογική δημιουργίας, σάρωσης, αναζήτησης και webhook.
Καλέστε στο POST /cards/invite με μια δοκιμαστική επαφή μιας χρήσης. Επαληθεύστε την επιστρεφόμενη εγκατάσταση URL πριν από την αυτοματοποίηση της παράδοσης σε πραγματικούς πελάτες.
Προσθέστε ενέργειες POST /cards/scan, κουπόνι ή μήνυμα μόνο αφού έχετε καταγραφή, χειρισμό σφαλμάτων και μια ασφαλή στρατηγική επανάληψης/idempotency στο δικό σας backend.
Η δημόσια αναφορά Swagger/OpenAPI περιέχει το τρέχον τελικό σημείο, την παράμετρο, το σώμα αιτήματος, την απόκριση και τα σχήματα webhook. Το διαδραστικό 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, backend, ιστότοπο ή πλήρη έλεγχο. Χρησιμοποιήστε το Make για οπτικά σενάρια διακλάδωσης. Χρησιμοποιήστε το Zapier για μια κυρίως γραμμική ροή εργασίας ενεργοποίησης ενεργοποίησης. Και τα τρία βασίζονται στο ίδιο κλειδί API και στο ίδιο συμβόλαιο API.
Σχετικές σελίδες
Επόμενο βήμα
Δημιουργήστε το κλειδί, καλέστε στο GET /templates, δημιουργήστε μία πρόσκληση για μια επαφή μιας χρήσης και, στη συνέχεια, προσθέστε μυστικά παραγωγής, καταγραφή, επαναλήψεις και χειρισμό webhook γύρω από το αποδεδειγμένο αίτημα.