Skip to content
Academy

Ρύθμιση

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

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

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

CDN

Section titled “CDN”

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

Το cloud_name μας είναι traveliko.

Cloudinary

Section titled “Cloudinary”

Παράδειγμα

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"
    }
  ]
}

Η επισημασμένη γραμμή παραπάνω δείχνει το μοναδικό ID του Cloudinary partners/radisson_blu_logo. Αυτό είναι όλο ό,τι χρειάζεστε για να ανακτήσετε την εικόνα σε οποιαδήποτε μορφή, ποιότητα και μέγεθος θέλετε.

Δοκιμές

Section titled “Δοκιμές”

Μεταβείτε στην ενότητα APIs και επιλέξτε το API με το οποίο θέλετε να εργαστείτε.

Τεκμηρίωση API

Section titled “Τεκμηρίωση API”

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

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

  1. Χρησιμοποιήστε το Lookup API για να ανακτήσετε προορισμούς ή ξενοδοχεία.
  2. Στο αριστερό navbar, κάντε κλικ στο Authentication.
  3. Εισάγετε το client-id και το client secret και πατήστε το κουμπί Get TOKEN.
  4. Αν τα διαπιστευτήριά σας είναι έγκυρα, θα δείτε ότι το κλειδί API σας έχει εφαρμοστεί.
  5. Τώρα μπορείτε να δοκιμάσετε το endpoint lookup.
Lookup API endpoint
Παράδειγμα Search Lookups (OAuth2)

Postman

Section titled “Postman”

Μπορείτε να κάνετε το ίδιο και με το Postman.

  1. Κατεβάστε το Postman.
  2. Κάντε κλικ στο Download OpenAPI spec από την κορυφή της σελίδας του Lookup API.
  3. Εισάγετέ το στο Postman.
  4. Αν το εισαγάγατε ως νέα συλλογή με όνομα Wink API, κάντε κλικ στις οριζόντιες ελλείψεις (3 τελείες) δίπλα στο όνομα της συλλογής και επιλέξτε Edit.
  5. Στην καρτέλα Authorization, ορίστε τον 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 στο Client Secret που δημιούργησε η εφαρμογή σας.
  13. Ορίστε το πεδίο Scope σε inventory.read inventory.write inventory.remove. Αυτά είναι όλα τα scopes που θα χρειαστείτε για το Wink.
  14. Ορίστε το πεδίο Client Authentication σε Send as Basic Auth header.
  15. Πατήστε το κουμπί Get New Access Token για να ανακτήσετε το token σας και να το αποθηκεύσετε.
  16. Για όλες τις κλήσεις API στη συλλογή Wink API, βεβαιωθείτε ότι η καρτέλα authentication λέει Inherit auth from parent ώστε να περιλαμβάνει το token σας σε κάθε κλήση.