Setup
Αυτό το άρθρο σάς δείχνει πώς να εγκατασταθείτε γρήγορα ως προγραμματιστής και να ξεκινήσετε να δοκιμάζετε τα API μας στο Wink.
:::σημείωση Οι δοκιμές θα πρέπει πάντα να πραγματοποιούνται στοπεριβάλλον προετοιμασίαςΥπάρχουν πολύ λιγότερα δεδομένα εκεί, αλλά είστε ελεύθεροι να δοκιμάσετε όσα θέλετε χωρίς να επιβάλλετε στο περιβάλλον παραγωγής.
Μόλις είστε έτοιμοι να δημοσιευτείτε, θα πιστοποιήσουμε τον λογαριασμό και την εφαρμογή σας και θα μπορείτε να την εκκινήσετε στο περιβάλλον παραγωγής μας. :::
Ακολουθήστε τα παρακάτω βήματα:
- Μητρώο ο λογαριασμός χρήστη σας στο Wink
- Δημιουργήστε ένα λογαριασμός ταξιδιωτικού πράκτορα ή ένα λογαριασμός συνεργάτη.
- Δημιουργήστε μια εφαρμογή όπου το συσχετίζετε με τον λογαριασμό που δημιουργήσατε στο Βήμα 2.
- Μόλις δημιουργήσετε το δικό σας
Application
, αποθηκεύστε το client-id και το μυστικό κωδικό πελάτη σε ασφαλές μέρος.
Στην Wink, χρησιμοποιούμε το Cloudinary για όλα τα αρχεία εικόνας και βίντεο. Όταν αποκτάτε πρόσβαση στο ταξιδιωτικό μας απόθεμα, θα έχετε πλήρη πρόσβαση σε όλες τις προηγμένες λειτουργίες του Cloudinary.
Μαςcloud_name
είναιtraveliko
.
Νεφελώδης
Section titled “Νεφελώδης”Παράδειγμα
Section titled “Παράδειγμα”Για κάθε τύπο αποθέματος ταξιδιών που υποστηρίζουμε, θα υπάρχει ένας ενσωματωμένος πίνακας JSON που ονομάζεταιmultimedias
Το JSON για μια καταχώρηση πολυμέσων μοιάζει με αυτό:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
Η επισημασμένη γραμμή παραπάνω δείχνει το μοναδικό αναγνωριστικό Cloudinarypartners/radisson_blu_logo
Αυτό είναι το μόνο που χρειάζεστε για να ανακτήσετε την εικόνα σε οποιαδήποτε μορφή, ποιότητα και μέγεθος θέλετε.
Δοκιμές
Section titled “Δοκιμές”Κατευθυνθείτε προς το μέρος μαςAPIκαι επιλέξτε το API με το οποίο θέλετε να εργαστείτε.
Έγγραφα API
Section titled “Έγγραφα API”Ο ιστότοπος τεκμηρίωσης έχει ρυθμιστεί με τέτοιο τρόπο ώστε να μπορείτε να εκτελείτε εντολές API μέσα από τον ιστότοπο.
Σε αυτό το παράδειγμα, θέλετε να χρησιμοποιήσετε τοSearch Lookups (OAuth2)
Κλήση API.
:::tip[Συμβουλή Επαγγελματικού Προγράμματος]
Για ευκολία στη χρήση, συνιστούμε στους ολοκληρωτές να χρησιμοποιούν τα τελικά σημεία που ορίζουμε ωςOAuth2
Αυτά τα τελικά σημεία γνωρίζουν να περιμένουν τους καλούντες API και γνωρίζουν ήδη σε ποιον λογαριασμό βρίσκεστε, επομένως δεν χρειάζεται να καθορίσετε τονcompanyIdentifier
στις διευθύνσεις URL σας.
:::
- Χρησιμοποιήστε το API αναζήτησης για να ανακτήσετε προορισμούς ή ξενοδοχεία.
- Στην αριστερή γραμμή πλοήγησης, κάντε κλικ στο
Authentication
. - Εισαγάγετε το αναγνωριστικό πελάτη και το μυστικό κλειδί πελάτη και κάντε κλικ στο
Get TOKEN
κουμπί. - Εάν τα διαπιστευτήριά σας είναι έγκυρα, θα δείτε ότι το κλειδί API σας έχει εφαρμοστεί.
- Τώρα μπορείτε να δοκιμάσετε το τελικό σημείο αναζήτησης.
Ταχυδρόμος
Section titled “Ταχυδρόμος”Μπορείτε να κάνετε το ίδιο πράγμα με τον Ταχυδρόμο.
- Λήψη Ταχυδρόμος.
- Κάντε κλικ στο
Download OpenAPI spec
από την κορυφή του API αναζήτησης σελίδα. - Εισαγάγετε το στο Postman.
- Αν το εισαγάγατε ως νέα συλλογή με την ονομασία
Wink API
, κάντε κλικ στην οριζόντια αποσιώπηση (3 τελείες) δίπλα στο όνομα της συλλογής και κάντε κλικEdit
. - Στο
Authorization tab
, ορίστε τοAuth type
στο OAuth2. - Ορισμός του πεδίου
Add auth data to
ναRequest headers
. - Ορισμός του πεδίου
Header prefix
ναBearer
. - Ορισμός του πεδίου
Token Name
σε όποιο όνομα θέλετε να δώσετε στο αποθηκευμένο σας token στο Postman. Π.χ. Wink Staging. - Ορισμός του πεδίου
Grant type
ναClient Credentials
. - Ορισμός του πεδίου
Access token URL
στη διεύθυνση https://staging-iam.wink.travel/oauth2/token. - Ορισμός του πεδίου
Client ID
στο Client ID που βοήθησε η εφαρμογή σας να δημιουργηθεί. - Ορισμός του πεδίου
Client Secret
στο Μυστικό Πελάτη που βοήθησε η εφαρμογή σας να δημιουργηθεί. - Ορισμός του πεδίου
Scope
ναinventory.read inventory.write inventory.remove
Αυτές είναι όλες οι διόπτρες που θα χρειαστείτε για το Wink. - Ορισμός του πεδίου
Client Authentication
ναSend as Basic Auth header
. - Κάντε κλικ στο
Get New Access Token
για να ανακτήσετε το διακριτικό σας και να το αποθηκεύσετε. - Για όλες τις κλήσεις API στη συλλογή Wink API, βεβαιωθείτε ότι η καρτέλα ελέγχου ταυτότητας αναφέρει
Inherit auth from parent
επομένως περιλαμβάνει το διακριτικό σας με κάθε κλήση.
:::tip[Συμβουλή επαγγελματία] Συνιστάται να μετατρέψετε τον τομέα του διακομιστή, το αναγνωριστικό πελάτη και το μυστικό πελάτη σε μεταβλητές περιβάλλοντος. Με αυτόν τον τρόπο, μπορείτε εύκολα να αλλάζετε μεταξύ περιβαλλόντων σταδιοποίησης και παραγωγής και να επαναχρησιμοποιείτε όλες τις λειτουργίες που έχετε δημιουργήσει. :::