Πώς να χρησιμοποιείτε το δημόσιο API του systeme.io (Διεπαφή Προγραμματισμού Εφαρμογών)

Σε αυτό το άρθρο, θα μάθετε πώς να διαμορφώσετε και να χρησιμοποιήσετε το δημόσιο API του systeme.io, περιλαμβάνοντας πώς να δημιουργείτε κλειδιά API και ποιες ενέργειες μπορείτε να πραγματοποιήσετε.

1. Τι είναι ένα API;

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

Εν συντομία, το systeme.io ανοίγει σε άλλες πλατφόρμες για να προσφέρει τις υπηρεσίες του εκεί όπου έχει προστιθέμενη αξία.

2. Πώς λειτουργεί το δημόσιο API μας;

Το API μας αποκαλύπτει ένα προσεκτικά επιλεγμένο σύνολο λειτουργιών που επιτρέπουν στους προγραμματιστές να αλληλεπιδρούν με την πλατφόρμα μας με διαφάνεια και αποτελεσματικότητα. Αν επιθυμείτε να μάθετε περισσότερα σχετικά με το πώς λειτουργεί, μπορείτε να διαβάσετε την επίσημη τεκμηρίωση API μας.

3. Πώς να δημιουργήσετε τα κλειδιά API σας

Τα κλειδιά API είναι μοναδικά αναγνωριστικά που πιστοποιούν τα αιτήματα προς το Δημόσιο API μας. Σας επιτρέπουν να έχετε προγραμματική πρόσβαση και να διαχειρίζεστε διάφορους πόρους στην πλατφόρμα μας.

Για να δημιουργήσετε ένα δημόσιο κλειδί API, κάντε κλικ στη φωτογραφία προφίλ σας, επιλέξτε Ρυθμίσεις (1) και κάντε κύλιση προς τα κάτω στην ενότητα MCP & Δημόσια κλειδιά API (2).

Κάντε κλικ στο Δημιουργία (3) για να ξεκινήσετε τη δημιουργία ενός δημόσιου κλειδιού API.

Στο αναδυόμενο παράθυρο Δημιουργία δημόσιου κλειδιού API, εισαγάγετε ένα όνομα, και επιλέξτε ημερομηνία και ώρα λήξης για το κλειδί API σας.

Μόλις ολοκληρώσετε, κάντε κλικ στο Αποθήκευση (4).

Σημείωση: Για να διατηρήσετε το κλειδί API ενεργό επ' αόριστον, αφήστε το πεδίο 'Λήξη' κενό.

Το κλειδί σας είναι τώρα έτοιμο.

4. Τι μπορείτε να κάνετε με το API μας;

Το API μας ανοίγει κάποιες ενδιαφέρουσες δυνατότητες. Παρακάτω θα βρείτε τις κύριες ενέργειες που μπορείτε να πραγματοποιήσετε χρησιμοποιώντας το δημόσιο API μας:

a. Επαφές, ετικέτες και προσαρμοσμένα πεδία:

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

• Διαχείριση ετικετών: Δημιουργία, ανάθεση, καταχώριση και αφαίρεση ετικετών από επαφές.

• Προσαρμοσμένα πεδία: Ανάκτηση διαθέσιμων προσαρμοσμένων πεδίων επαφών και των ταυτοτήτων τους (slugs) για σωστή συμπλήρωση πληροφοριών επαφών.

b. Ενημερωτικά δελτία:

• Δημιουργία και ενημέρωση ενημερωτικών δελτίων: Δημιουργία νέων προσχεδίων ενημερωτικών δελτίων ή μερική ενημέρωση των υπαρχόντων. Μπορείτε να ορίσετε τον τύπο του επεξεργαστή (Κλασικός ή Οπτικός), να ανακτήσετε το πλήρες περιεχόμενο HTML και να ορίσετε ρητά το όνομα και τη διεύθυνση email του αποστολέα.

• Καταχώριση και ανάκτηση: Αναζητήστε τα υπάρχοντα ενημερωτικά δελτία σας ή ανακτήστε το πλήρες περιεχόμενο ενός συγκεκριμένου ενημερωτικού δελτίου χρησιμοποιώντας το ID του.

c. Χωνιά και επεξεργαστής σελίδων:

• Διαχείριση χωνιών: Δημιουργία νέων χωνιών, προσθήκη νέων βημάτων (σελίδων) σε αυτά και ανάκτηση μιας λίστας από όλα τα ατομικά βήματα μέσα σε ένα συγκεκριμένο χωνί.

• Επεξεργαστής σελίδων: Αποθήκευση του παραγόμενου περιεχομένου σελίδας απευθείας στα βήματα του χωνιού σας ή στις σελίδες του ιστότοπου (πλήρης αντικατάσταση) και ανάκτηση σχημάτων JSON για συγκεκριμένους τύπους σελίδων.

d. Σχέδια τιμών και κουπόνια:

• Δημιουργία, επεξεργασία και διαγραφή: Δημιουργία νέων σχεδίων τιμών και κουπονιών, ή μερική ενημέρωση και διαγραφή των υπαρχόντων.

• Καταχώριση και αναζήτηση: Αναζητήστε όλα τα υπάρχοντα σχέδια τιμών και κουπόνια σας, ή ανακτήστε συγκεκριμένα είδη με το ID τους.

e. Μαθήματα και μαθητές:

• Διαχείριση μαθημάτων και μαθητών: Ανάκτηση μιας λίστας από τα υπάρχοντα μαθήματά σας και ανάκτηση μιας λίστας μαθητών που είναι αυτή τη στιγμή εγγεγραμμένοι.

• Εγγραφή μαθητών: Εγγραφή επαφών στα ατομικά μαθήματα σας προγραμματιστικά.

Σημείωση για τα μαθήματα: Η υποστήριξη για πακέτα μαθημάτων θα προστεθεί σε μελλοντικές ενημερώσεις.

f. Κοινότητες:

• Διαχείριση κοινοτήτων: Ανάκτηση μιας λίστας από τις υπάρχουσες κοινότητές σας και πρόσβαση σε μια λίστα των τωρινών μελών μέσα σε μια συγκεκριμένη κοινότητα.

• Πρόσκληση μελών: Πρόσκληση νέων χρηστών να ενταχθούν στις κοινότητές σας παρέχοντας το ID επαφής τους.

g. Κανόνες αυτοματισμού:

• Διαχείριση κανόνων: Προγραμματιστική σύνδεση κοινών γεγονότων και ενεργειών, ενημέρωση υπαρχόντων κανόνων (π.χ., αλλάζοντας μια ενέργεια ενώ διατηρείται η ίδια η σκανδάλη), ή ήπια διαγραφή κανόνων.

• Καταχώριση και ανάκτηση: Αναζητήστε τους κανόνες αυτοματισμού σας ή ανακτήστε έναν συγκεκριμένο κανόνα με το ID του.

h. Συνδρομές:

• Διαχείριση συνδρομών: Ανάκτηση μιας λίστας από όλους τους πόρους σε μια συνδρομή από πλατφόρμες τρίτων, και ακύρωση μιας συνδρομής είτε άμεσα είτε στο τέλος του κύκλου χρέωσης.

i. Webhooks

• Διαχείριση webhooks: Δημιουργία νέων webhooks για να λαμβάνετε ειδοποιήσεις σε πραγματικό χρόνο, ανάκτηση λιστών με τα υπάρχοντα webhooks, και απενεργοποίηση webhooks που δεν είναι πλέον απαραίτητα.

Σημειώσεις:

• Για να μπορείτε να αναγνωρίζετε και να διαχειρίζεστε εύκολα τα token σας, το καθένα πρέπει να έχει μοναδικό όνομα.

• Ένα token μπορεί να αντιγραφεί μόνο αμέσως μετά τη δημιουργία του. Αν ξεχάσατε να το αντιγράψετε, διαγράψτε το και δημιουργήστε ένα νέο.

• Για λόγους ασφαλείας, θα σας αποστέλλεται ειδοποίηση μέσω email κάθε φορά που δημιουργείται ένα νέο δημόσιο κλειδί API στον λογαριασμό σας στο systeme.io.

• Μπορείτε να δημιουργήσετε έως και 3 κλειδιά API ανά λογαριασμό.

Μάθετε περισσότερα: Τεκμηρίωση API.