Οι περισσότεροι συμπληρώνουν φόρμες σε πρόγραμμα περιήγησης. Οι προγραμματιστές όμως χτίζουν φόρμες μέσα σε εφαρμογές που φτιάχνουν οι ίδιοι, σε εφαρμογές κινητού, σε ενσωματωμένα συστήματα και σε εσωτερικά εργαλεία. Αυτές οι φόρμες δεν χρησιμοποιούν τον δημιουργό φορμών με μεταφορά και απόθεση. Χρησιμοποιούν API για να στέλνουν δεδομένα απευθείας στην πλατφόρμα φορμών σου.
Εδώ θα δεις πώς δουλεύουν τα API φορμών, πότε τα χρειάζεσαι και τι να ψάξεις σε μια πλατφόρμα φορμών με σωστή πρόσβαση API.
Τι είναι ένα API φορμών και γιατί το χρησιμοποιούν οι προγραμματιστές
Ένα API φορμών είναι ένας τρόπος για τους προγραμματιστές να στέλνουν δεδομένα φόρμας μέσω κώδικα, αντί για μια φόρμα στο πρόγραμμα περιήγησης. Αντί κάποιος να πατά το κουμπί "υποβολή" σε μια φόρμα ιστοσελίδας, ο προγραμματιστής γράφει κώδικα που στέλνει τα δεδομένα απευθείας στο σύστημα φορμών.
Πότε θα το έκανες αυτό;
Φτιάχνεις δική σου εφαρμογή: Φτιάχνεις τη δική σου εφαρμογή και θες να συλλέγεις δεδομένα φόρμας με το εργαλείο φορμών ως backend. Ο κώδικάς σου καλεί το API φορμών για να υποβάλει.
Υποβολή φόρμας από εφαρμογή κινητού: Έχεις μια εφαρμογή κινητού με φόρμα. Όταν οι χρήστες υποβάλλουν, ο κώδικας της εφαρμογής καλεί το API φορμών.
Ενοποίηση δεδομένων από πολλές πηγές: Συλλέγεις δεδομένα από διάφορα συστήματα και θες όλα να καταλήγουν σε μία πλατφόρμα φορμών. Ο κώδικας ενοποίησής σου χρησιμοποιεί το API φορμών.
Μαζικές εργασίες: Έχεις χιλιάδες εγγραφές που θες να εισαγάγεις. Αντί να τις πληκτρολογείς χειροκίνητα, ο κώδικάς σου χρησιμοποιεί το API φορμών για να τις υποβάλει προγραμματιστικά.
Πώς δουλεύουν τα API φορμών (χωρίς να χρειάζεται να καταλαβαίνεις κώδικα)
Ένα API φορμών δουλεύει έτσι: Η εφαρμογή σου έχει δεδομένα. Θέλει να τα στείλει στην πλατφόρμα φορμών. Κάνει μια κλήση API (σκέψου την σαν ένα μήνυμα) που λέει "ορίστε κάποια δεδομένα, αποθήκευσέ τα". Η πλατφόρμα φορμών τα παραλαμβάνει, τα ελέγχει και τα αποθηκεύει όπως θα έκανε αν κάποιος είχε συμπληρώσει μια φόρμα ιστοσελίδας και είχε πατήσει υποβολή.
Η πλατφόρμα φορμών επιστρέφει μια απάντηση που επιβεβαιώνει ότι η υποβολή παραλήφθηκε και αποθηκεύτηκε.
Από την πλευρά της πλατφόρμας φορμών, τα δεδομένα μιας υποβολής μέσω API είναι ίδια με τα δεδομένα μιας υποβολής από φόρμα ιστοσελίδας. Και τα δύο αντιμετωπίζονται το ίδιο.
Πιστοποίηση και ασφάλεια API
Όταν ο κώδικάς σου καλεί ένα API φορμών, πρέπει να αποδείξει ότι έχει εξουσιοδότηση. Αυτό γίνεται με πιστοποίηση, συνήθως με ένα κλειδί API.
Ένα κλειδί API είναι σαν κωδικός πρόσβασης για την εφαρμογή σου. Το κρατάς μυστικό. Όταν ο κώδικάς σου θέλει να στείλει δεδομένα, συμπεριλαμβάνει το κλειδί API. Η πλατφόρμα φορμών ελέγχει το κλειδί και λέει "ναι, αυτή η εφαρμογή έχει εξουσιοδότηση".
Μην δημοσιεύεις ποτέ το κλειδί API σε δημόσιο κώδικα και μην το μοιράζεσαι. Αν κάποιος το αποκτήσει, μπορεί να στέλνει δεδομένα φόρμας εκ μέρους σου (κάτι που μπορεί να γίνει πρόβλημα αν παίρνεις επιχειρηματικές αποφάσεις με βάση τις υποβολές).
Όριο κλήσεων: πόσες κλήσεις API επιτρέπονται
Οι περισσότερες πλατφόρμες φορμών περιορίζουν πόσες κλήσεις API μπορείς να κάνεις. Έτσι αποφεύγεται η κατάχρηση και προστατεύεται το σύστημα.
Ένα τυπικό όριο μπορεί να είναι "1,000 κλήσεις API ανά ώρα ανά κλειδί API". Αν η εφαρμογή σου κάνει περισσότερες κλήσεις από το όριο, οι επόμενες απορρίπτονται μέχρι να μηδενιστεί η ώρα.
Όταν διαλέγεις πλατφόρμα φορμών, έλεγξε τα όρια κλήσεων API. Αν χρειάζεται να κάνεις 10,000 υποβολές την ώρα, ένα όριο 1,000 κλήσεων την ώρα δεν σε καλύπτει. Ρώτησε την πλατφόρμα για υψηλότερα όρια ή επιλογές κλιμάκωσης.
Απαντήσεις API και χειρισμός σφαλμάτων
Όταν ο κώδικάς σου καλεί το API φορμών, παίρνει μια απάντηση. Η απάντηση σου λέει αν η υποβολή πέτυχε ή απέτυχε.
Απάντηση επιτυχίας: HTTP 200 ή 201. Η υποβολή παραλήφθηκε και αποθηκεύτηκε. Ο κώδικάς σου μπορεί να συνεχίσει.
Απάντηση σφάλματος: HTTP 400, 401, 500 κ.λπ. Κάτι πήγε στραβά. Ο κώδικάς σου πρέπει να χειριστεί το σφάλμα (να ξαναδοκιμάσει, να το καταγράψει, να ειδοποιήσει κάποιον).
Τα καλά μηνύματα σφάλματος API σου λένε τι πήγε στραβά. Το "Missing required field: email" βοηθά. Ένα "Error" χωρίς λεπτομέρειες όχι.
Μαζικές υποβολές μέσω API
Μερικές φορές έχεις πολλές υποβολές να στείλεις μαζί. Κάποια API υποστηρίζουν μαζικές εργασίες: στέλνεις 100 υποβολές σε μία κλήση API αντί για 100 ξεχωριστές κλήσεις.
Οι μαζικές υποβολές είναι πιο αποδοτικές. Μειώνουν τον αριθμό των κλήσεων API και ολοκληρώνονται πιο γρήγορα.
Έλεγξε αν το API της πλατφόρμας φορμών σου υποστηρίζει μαζικές υποβολές. Αν χρειάζεται να εισαγάγεις μεγάλο όγκο δεδομένων, αυτό το χαρακτηριστικό μετράει.
Ειδοποιήσεις webhook από την πλευρά του API
Όταν τα δεδομένα έρχονται μέσω API, ίσως θες ειδοποιήσεις ή επόμενες ενέργειες. Κάποιες πλατφόρμες φορμών στέλνουν ειδοποιήσεις webhook για υποβολές API όπως και για υποβολές από φόρμες ιστοσελίδας.
Αυτό σημαίνει ότι, αν ο κώδικάς σου υποβάλλει μέσω API, τα συστήματα που ακολουθούν (CRM, email κ.λπ.) ειδοποιούνται πάλι αυτόματα.
Τεκμηρίωση API και εμπειρία προγραμματιστή
Ένα καλό API φορμών έχει εξαιρετική τεκμηρίωση. Εξηγεί πώς γίνεται η πιστοποίηση, ποιο endpoint καλείς, ποια μορφή δεδομένων χρησιμοποιείς, ποια σφάλματα μπορεί να πάρεις, και περιλαμβάνει παραδείγματα κώδικα.
Η κακή τεκμηρίωση API κάνει τη ζωή του προγραμματιστή δύσκολη. Αν διαλέγεις πλατφόρμα φορμών και χρειάζεσαι πρόσβαση API, διάβασε πρώτα την τεκμηρίωσή της. Είναι σαφής; Έχει παραδείγματα; Την καταλαβαίνεις;
Πότε να χρησιμοποιείς API και πότε φόρμες ιστοσελίδας
Χρησιμοποίησε φόρμα ιστοσελίδας όταν: Θες οι επισκέπτες να συμπληρώνουν μια φόρμα στο πρόγραμμα περιήγησής τους. Δεν χρειάζεσαι κώδικα. Η διεπαφή μεταφοράς και απόθεσης του δημιουργού φορμών αρκεί.
Χρησιμοποίησε API όταν: Είσαι προγραμματιστής και φτιάχνεις δική σου εφαρμογή. Χρειάζεται να στέλνεις δεδομένα προγραμματιστικά. Ενοποιείς πολλές πηγές δεδομένων. Χρειάζεται να προσαρμόσεις ολόκληρη την εμπειρία υποβολής.
Συχνά χρησιμοποιείς και τα δύο. Μια ιστοσελίδα έχει φόρμες για τους επισκέπτες. Η εσωτερική σου εφαρμογή χρησιμοποιεί το API για προγραμματιστικές υποβολές.
Πώς να ξεκινήσεις με φόρμες στη WEMASY
Με τον δημιουργό ιστοσελίδων της WEMASY φτιάχνεις τις δικές σου σελίδες στην ιστοσελίδα σου και μπορείς να προσθέσεις μια φόρμα. Δες τη σελίδα με τα πακέτα της WEMASY.