Setup

Αυτό το άρθρο σάς δείχνει πώς να εγκατασταθείτε γρήγορα ως προγραμματιστής και να ξεκινήσετε να δοκιμάζετε τα API μας στο Wink.

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

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

Ακολουθήστε τα παρακάτω βήματα:

1. Μητρώο ο λογαριασμός χρήστη σας στο Wink
2. Δημιουργήστε ένα λογαριασμός ταξιδιωτικού πράκτορα ή ένα λογαριασμός συνεργάτη.
3. Δημιουργήστε μια εφαρμογή όπου το συσχετίζετε με τον λογαριασμό που δημιουργήσατε στο Βήμα 2.
4. Μόλις δημιουργήσετε το δικό σας Application, αποθηκεύστε το client-id και το μυστικό κωδικό πελάτη σε ασφαλές μέρος.

CDN

Στην Wink, χρησιμοποιούμε το Cloudinary για όλα τα αρχεία εικόνας και βίντεο. Όταν αποκτάτε πρόσβαση στο ταξιδιωτικό μας απόθεμα, θα έχετε πλήρη πρόσβαση σε όλες τις προηγμένες λειτουργίες του Cloudinary.

Μαςcloud_nameείναιtraveliko.

Νεφελώδης

• Ξεκινώντας
• SDK
• Cloudinary στο GitHub
• Εκπαιδευτικά βίντεο

Παράδειγμα

Για κάθε τύπο αποθέματος ταξιδιών που υποστηρίζουμε, θα υπάρχει ένας ενσωματωμένος πίνακας 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Αυτό είναι το μόνο που χρειάζεστε για να ανακτήσετε την εικόνα σε οποιαδήποτε μορφή, ποιότητα και μέγεθος θέλετε.

Δοκιμές

Κατευθυνθείτε προς το μέρος μαςAPIκαι επιλέξτε το API με το οποίο θέλετε να εργαστείτε.

Έγγραφα API

Ο ιστότοπος τεκμηρίωσης έχει ρυθμιστεί με τέτοιο τρόπο ώστε να μπορείτε να εκτελείτε εντολές API μέσα από τον ιστότοπο.

Σε αυτό το παράδειγμα, θέλετε να χρησιμοποιήσετε τοSearch Lookups (OAuth2)Κλήση API.

:::tip[Συμβουλή Επαγγελματικού Προγράμματος] Για ευκολία στη χρήση, συνιστούμε στους ολοκληρωτές να χρησιμοποιούν τα τελικά σημεία που ορίζουμε ωςOAuth2Αυτά τα τελικά σημεία γνωρίζουν να περιμένουν τους καλούντες API και γνωρίζουν ήδη σε ποιον λογαριασμό βρίσκεστε, επομένως δεν χρειάζεται να καθορίσετε τονcompanyIdentifierστις διευθύνσεις URL σας. :::

1. Χρησιμοποιήστε το API αναζήτησης για να ανακτήσετε προορισμούς ή ξενοδοχεία.
2. Στην αριστερή γραμμή πλοήγησης, κάντε κλικ στο Authentication.
3. Εισαγάγετε το αναγνωριστικό πελάτη και το μυστικό κλειδί πελάτη και κάντε κλικ στο Get TOKEN κουμπί.
4. Εάν τα διαπιστευτήριά σας είναι έγκυρα, θα δείτε ότι το κλειδί API σας έχει εφαρμοστεί.
5. Τώρα μπορείτε να δοκιμάσετε το τελικό σημείο αναζήτησης.

Δείγματα αναζητήσεων αναζήτησης (OAuth2)

Ταχυδρόμος

Μπορείτε να κάνετε το ίδιο πράγμα με τον Ταχυδρόμο.

1. Λήψη Ταχυδρόμος.
2. Κάντε κλικ στο Download OpenAPI spec από την κορυφή του API αναζήτησης σελίδα.
3. Εισαγάγετε το στο Postman.
4. Αν το εισαγάγατε ως νέα συλλογή με την ονομασία Wink API, κάντε κλικ στην οριζόντια αποσιώπηση (3 τελείες) δίπλα στο όνομα της συλλογής και κάντε κλικ Edit.
5. Στο Authorization tab, ορίστε το Auth type στο OAuth2.
6. Ορισμός του πεδίου Add auth data to να Request headers.
7. Ορισμός του πεδίου Header prefix να Bearer.
8. Ορισμός του πεδίου Token Name σε όποιο όνομα θέλετε να δώσετε στο αποθηκευμένο σας token στο Postman. Π.χ. Wink Staging.
9. Ορισμός του πεδίου Grant type να Client Credentials.
10. Ορισμός του πεδίου Access token URL στη διεύθυνση https://staging-iam.wink.travel/oauth2/token.
11. Ορισμός του πεδίου Client ID στο Client ID που βοήθησε η εφαρμογή σας να δημιουργηθεί.
12. Ορισμός του πεδίου Client Secret στο Μυστικό Πελάτη που βοήθησε η εφαρμογή σας να δημιουργηθεί.
13. Ορισμός του πεδίου Scope να inventory.read inventory.write inventory.removeΑυτές είναι όλες οι διόπτρες που θα χρειαστείτε για το Wink.
14. Ορισμός του πεδίου Client Authentication να Send as Basic Auth header.
15. Κάντε κλικ στο Get New Access Token για να ανακτήσετε το διακριτικό σας και να το αποθηκεύσετε.
16. Για όλες τις κλήσεις API στη συλλογή Wink API, βεβαιωθείτε ότι η καρτέλα ελέγχου ταυτότητας αναφέρει Inherit auth from parent επομένως περιλαμβάνει το διακριτικό σας με κάθε κλήση.

:::tip[Συμβουλή επαγγελματία] Συνιστάται να μετατρέψετε τον τομέα του διακομιστή, το αναγνωριστικό πελάτη και το μυστικό πελάτη σε μεταβλητές περιβάλλοντος. Με αυτόν τον τρόπο, μπορείτε εύκολα να αλλάζετε μεταξύ περιβαλλόντων σταδιοποίησης και παραγωγής και να επαναχρησιμοποιείτε όλες τις λειτουργίες που έχετε δημιουργήσει. :::