Mετάβαση στο κύριο περιεχόμενο

API

Συνδέστε το Loyaltify με τα δικά σας συστήματα μέσω του API.

Συντάχθηκε από: Berke Atik

Το Loyaltify API επιτρέπει στον προγραμματιστή σας να συνδέσει το Loyaltify με τα δικά σας συστήματα, όπως ένα ταμείο, ένα εργαλείο κρατήσεων ή τον ιστότοπό σας. Για παράδειγμα, ένα ταμείο μπορεί να προσθέτει πόντους αυτόματα μετά από κάθε πώληση, ώστε η ομάδα σας να μη χρειάζεται να σαρώνει την κάρτα.

Αυτός ο οδηγός απευθύνεται σε εσάς και στον προγραμματιστή σας: πού θα βρείτε το κλειδί API σας, πού βρίσκεται η τεκμηρίωση και τι αξίζει να ξέρετε πριν ξεκινήσετε την υλοποίηση.

💡 Καλό να ξέρετε: Αυτό αποτελεί μέρος του πακέτου Advanced. Σταματά να λειτουργεί αν μεταβείτε σε χαμηλότερο πακέτο.

Βρείτε το κλειδί API σας

  1. Στο Loyaltify, κάντε κλικ στο όνομά σας πάνω δεξιά.

  2. Μεταβείτε στο Το προφίλ σας και αντιγράψτε το κλειδί API σας.

Δεν βλέπετε κλειδί API στον λογαριασμό σας Advanced; Επικοινωνήστε με την υποστήριξη μέσω της ζωντανής συνομιλίας και θα το ενεργοποιήσουμε για εσάς.

⚠️ Να αντιμετωπίζετε το κλειδί API σας όπως έναν κωδικό πρόσβασης. Μοιραστείτε το μόνο με τον προγραμματιστή σας και μην το βάζετε ποτέ στον κώδικα ενός ιστότοπου ή σε έναν σύνδεσμο.


Διαβάστε την τεκμηρίωση

Η πλήρης τεκμηρίωση του API βρίσκεται στο api.loyaltify.io/api-docs. Μερικά πράγματα που πρέπει να ξέρει ο προγραμματιστής σας:

  • Στέλνετε το κλειδί API στην κεφαλίδα X-API-Key με κάθε αίτημα.

  • Χρησιμοποιείτε τη live διεύθυνση, api.loyaltify.io.

  • Αν ανοίξετε ένα endpoint στον browser σας, θα εμφανιστεί «Unauthorized». Αυτό είναι αναμενόμενο, επειδή ο browser δεν στέλνει το κλειδί σας.


Τι μπορείτε να κάνετε με το API

  • Εγγραφή πελατών μέσω μιας από τις φόρμες εγγραφής σας, για παράδειγμα από τον δικό σας ιστότοπο ή την εφαρμογή σας. Η απάντηση περιλαμβάνει τους συνδέσμους της κάρτας του πελάτη για Apple Wallet και Google Wallet.

  • Αναζήτηση πελατών και των συναλλαγών τους, ενημέρωση των στοιχείων τους ή διαγραφή τους.

  • Προσθήκη σφραγίδων, πόντων ή πίστωσης ή εξαργύρωση ανταμοιβών με ένα αίτημα σάρωσης, όπως ακριβώς κάνει η ομάδα σας στην εφαρμογή Store. Τι στέλνετε εξαρτάται από τον τύπο της κάρτας.


Καλό να ξέρετε

  • Ο κωδικός QR σε κάθε κάρτα έχει πάντα την ίδια μορφή: lytf-, το ID του καταστήματός σας και μετά το ID του πελάτη. Ένα ταμείο μπορεί να τον διαβάσει για να βρει τον σωστό πελάτη.

  • Κάθε πελάτης έχει δύο ID: ένα σύντομο ID πελάτη (αυτό που εμφανίζεται στην κάρτα του και στα webhooks) και έναν εσωτερικό αριθμό που χρησιμοποιείται σε ορισμένα αιτήματα API. Η τεκμηρίωση δείχνει πώς να βρείτε το ένα από το άλλο.

  • Χρειάζεστε το ID του καταστήματός σας; Επικοινωνήστε με την υποστήριξη μέσω της ζωντανής συνομιλίας.

  • Πολλές τοποθεσίες ή ταμεία μπορούν να χρησιμοποιούν όλα το ίδιο κλειδί API.

  • Θέλετε να μαθαίνετε πότε συμβαίνει κάτι; Χρησιμοποιήστε τα Webhooks για να λαμβάνετε ένα μήνυμα κάθε φορά που ένας πελάτης εγγράφεται ή κερδίζει.

💡 Θέλετε να το υλοποιήσουμε εμείς; Δημιουργούμε επίσης προσαρμοσμένες ενσωματώσεις, με ξεχωριστή προσφορά. Επικοινωνήστε μαζί μας μέσω της ζωντανής συνομιλίας και πείτε μας ποιο σύστημα χρησιμοποιείτε και τι θα θέλατε να συμβαίνει.


Χρειάζεστε βοήθεια;

Είμαστε εδώ για να βοηθήσουμε!

Αν έχετε οποιαδήποτε ερώτηση για το API, επικοινωνήστε μαζί μας μέσω της ζωντανής συνομιλίας μέσα στο Loyaltify ή χρησιμοποιήστε το κουμπί συνομιλίας κάτω δεξιά σε αυτή τη σελίδα. Η ομάδα μας θα χαρεί να σας βοηθήσει.

Απαντήθηκε η ερώτησή σας;