Συνδέστε τα εργαλεία σας με το API

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

Μάθετε αν το API σας αφορά

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

Για τις καθημερινές ανάγκες — ανάκτηση της λίστας των μελών, μαζική ενημέρωση συνδρομών, αποστολή στοιχείων στο διοικητικό συμβούλιο — τα modules εισαγωγής, εξαγωγής και αναφορών καλύπτουν τις απαιτήσεις χωρίς να γράψετε ούτε μια γραμμή κώδικα.

Το API προσφέρεται σε έκδοση beta: η λειτουργία του μπορεί να εξελιχθεί ακόμη.

Ενεργοποιήστε το API και ανακτήστε το κλειδί σας

1. Μεταβείτε στο Διαχείριση›Ρυθμίσεις›API BETA.
2. Ενεργοποιήστε το Ενεργοποίηση της μονάδας API και έπειτα κάντε κλικ στο Αποθήκευση.
3. Το Κλειδί API σας εμφανίζεται: αντιγράψτε το με το κουμπί Αντιγραφή και δώστε το μόνο στο εργαλείο που συνδέετε.

Το κλειδί αποστέλλεται στην κεφαλίδα HTTP X-API-Key κάθε αιτήματος. Οι κλήσεις γίνονται υποχρεωτικά μέσω HTTPS· κανένα μη κρυπτογραφημένο αίτημα δεν γίνεται δεκτό.

Προστατέψτε το κλειδί

Ορισμένες καλές πρακτικές αξίζει να υπενθυμιστούν στο εργαλείο ή στον συνεργάτη που το χρησιμοποιεί:

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

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

Περιορίστε την πρόσβαση ανά διεύθυνση IP

Ενεργοποιήστε τον Περιορισμός ανά διεύθυνση IP: γίνονται δεκτά μόνο τα αιτήματα που προέρχονται από τις διευθύνσεις που καταχωρείτε, με ανώτατο όριο 10 διευθύνσεις IPv4. Καταχωρήστε κάθε διεύθυνση και επιβεβαιώστε με Προσθήκη· η τρέχουσα διεύθυνσή σας εμφανίζεται στην οθόνη για να σας βοηθήσει.

Είναι η πιο αποτελεσματική προστασία, και η πιο συχνά παραμελημένη: ακόμη κι αν διαρρεύσει, ένα κλειδί περιορισμένο στη διεύθυνση του συνεργάτη σας παραμένει άχρηστο αλλού.

Παρακολουθήστε την κατανάλωση

Η οθόνη εμφανίζει διαρκώς τι καταναλώνει το κλειδί σας:

• Χρήση αυτό το λεπτό και Χρήση σήμερα, το καθένα σε σχέση με το όριό του όταν έχει ρυθμιστεί όριο·
• Στατιστικά Χρήσης: Αυτή την εβδομάδα, Αυτόν τον μήνα, Σύνολο και Τελευταίο αίτημα.

Πάνω από τα αναγραφόμενα όρια, τα επιπλέον αιτήματα απορρίπτονται προσωρινά. Ένας μετρητής που αγγίζει διαρκώς το ανώτατο όριό του υποδεικνύει συνήθως ένα κακορυθμισμένο εργαλείο, το οποίο ζητά ξανά και ξανά τα ίδια δεδομένα αντί να τα αποθηκεύει στην cache.

Η ημερομηνία του τελευταίου αιτήματος είναι χρήσιμη από την αντίθετη πλευρά: ένα κλειδί ενεργοποιημένο αλλά που δεν έχει κληθεί ποτέ επί μήνες είναι ένα κλειδί προς απενεργοποίηση.

Ανακαλύψτε τι επιτρέπει το API

Η πλήρης τεκμηρίωση, με τις παραμέτρους και παραδείγματα κλήσεων, εμφανίζεται στο κάτω μέρος της οθόνης του module. Σε γενικές γραμμές:

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