Ο παρών οδηγός εξηγεί εν συντομία πώς να ξεκινήσετε με το REST API στο ConnectedCooking. Λάβετε υπόψη ότι ο οδηγός αυτός αναφέρεται αποκλειστικά στις λύσεις Cloud REST API που προσφέρουμε.
- Πρώτα, πρέπει να δημιουργήσετε έναν πελάτη API στον λογαριασμό σας στο ConnectedCooking. Για τον σκοπό αυτό, μεταβαίνετε στον λογαριασμό σας στο ConnectedCooking και επιλέγετε την καρτέλα «Διαχείριση».
- Στη συνέχεια, κάντε κλικ στην επιλογή «Ενσωματώσεις». Η καρτέλα «API» είναι ορατή μόνο στους διαχειριστές λογαριασμού.
- Στη συνέχεια, κάνετε κλικ στο «+ Προσθήκη νέου»
- Στην επόμενη εικόνα, εισάγετε ένα «ALIAS», ορίζετε μια ΟΜΑΔΑ και επιλέγετε έναν τύπο API. Για τα ερωτήματα API που αφορούν το HACCP και τα δεδομένα στον λογαριασμό σας στο ConnectedCooking, χρειάζεστε τον τύπο API «Base API». Αφού συμπληρώσετε όλες τις στήλες, κάνετε κλικ στο «Προσθήκη API».
- Στην επόμενη οθόνη θα λάβετε τα διαπιστευτήρια πελάτη API. Παρακαλούμε να τα φυλάξετε σε ασφαλές μέρος και να κάνετε κλικ στο κουμπί «Κλείσιμο».
- Αφού δημιουργήσετε τον πελάτη API σας, θα χρειαστείτε ένα εργαλείο για να τον χρησιμοποιήσετε. Για τον σκοπό αυτό, μπορείτε να χρησιμοποιήσετε το curl, το Postman ή οποιοδήποτε άλλο εργαλείο γνωρίζετε. Σε αυτόν τον οδηγό χρησιμοποιούμε το Postman.
- Εκκινήστε το Postman μέσω της εφαρμογής ή σε έναν περιηγητή ιστού. Στη συνέχεια, δημιουργήστε μια νέα κενή συλλογή χρησιμοποιώντας το σύμβολο «+» και, μετά, κάντε κλικ στην επιλογή «Προσθήκη αιτήματος». Εναλλακτικά, μπορείτε επίσης να δημιουργήσετε απλώς ένα νέο αίτημα HTTP κάνοντας κλικ στην επιλογή «Νέο».
- Επιπλέον, πρέπει να τροποποιήσετε το αίτημα που μόλις δημιουργήσατε σε αίτημα POST, προκειμένου να λάβετε το Bearer Token με τη βοήθεια των διαπιστευτηρίων του API Client σας από το ConnectedCooking.
- Επομένως, πρέπει να συμβουλευτείτε την τεκμηρίωση του API Επαλήθευση ταυτότητας | Κέντρο βοήθειας του ConnectedCooking
- Στην τεκμηρίωση εξηγείται ότι πρέπει να δημιουργήσετε ένα Bearer Token για να πιστοποιήσετε τις επόμενες αιτήσεις σας στο API.
- Αυτό επιτυγχάνεται μέσω ενός αιτήματος POST. Το αίτημα POST χρησιμοποιεί το σημείο τερματισμού: https://app.connectedcooking.com/api/auth/access
- Επιπλέον, πρέπει να ορίσετε τον τύπο περιεχομένου «x-www-form-urlencoded» στην καρτέλα «Κύριο κείμενο» του αιτήματός σας. Στη συνέχεια, το όνομα χρήστη, ο κωδικός πρόσβασης και το πεδίο εφαρμογής του πελάτη API σας πρέπει να εισαχθούν στις διαθέσιμες στήλες.
- Στο τέλος, κάνετε κλικ στο «Αποστολή» και θα πρέπει πλέον να λάβετε το «accessToken = BearerToken» σας
- Για να χρησιμοποιήσετε το BearerToken που μόλις δημιουργήσατε, χρειάζεστε κάποιο API.
- Μπορείτε να δείτε εύκολα όλα τα πιθανά αιτήματα API στην τεκμηρίωση των Endpoints: Τερματικά | Κέντρο βοήθειας ConnectedCooking
- Για παράδειγμα, δοκιμάστε να χρησιμοποιήσετε το Endpoint «Λίστα συσκευών».
- Αυτή η αίτηση είναι πολύ απλή, καθώς αρκεί να χρησιμοποιήσετε το «https://app.connectedcooking.com», να προσθέσετε το «/api/public/devices» σε αυτό και να αντιγράψετε/επικολλήσετε το «accessToken» από την αίτησή σας POST στην καρτέλα «Authorization», όπως φαίνεται στην παρακάτω εικόνα. Απλώς επιλέξτε «Bearer Token» στο πεδίο «Auth Type» και, στη συνέχεια, θα εμφανιστεί το πεδίο «Token».
- Στο τέλος, κάντε επίσης κλικ στο «Αποστολή» και θα λάβετε μια λίστα με όλες τις συσκευές που έχετε καταχωρίσει στον λογαριασμό σας στο ConnectedCooking (η λίστα αυτή θα είναι κενή αν δεν έχετε συσκευές στον λογαριασμό σας).
Αυτό το παράδειγμα μπορεί ουσιαστικά να εφαρμοστεί σε όλα τα τερματικά.
Συγχαρητήρια, μπορείτε πλέον να χρησιμοποιείτε τα REST API με το ConnectedCooking!
Εάν χρειάζεστε περισσότερες πληροφορίες, παρακαλούμε ανατρέξτε στην Τεκμηρίωση API για το ConnectedCooking: Εισαγωγή | Κέντρο βοήθειας του ConnectedCooking
