Πιστοποίηση

Μια εφαρμογή σας παρέχει ένα Client ID και ένα Secret Key που χρειάζεστε για να δημιουργήσετε μια πιστοποιημένη συνεδρία OAuth2 την οποία μπορείτε να χρησιμοποιήσετε για να επικοινωνήσετε με τα APIs της Wink και της TripPay.

Ακολουθούν τα βήματα για να δημιουργήσετε μια πιστοποιημένη συνεδρία.

Βήμα 1. Ανάκτηση ενός access token στο staging ή στο περιβάλλον παραγωγής μας:

Πιθανότατα θα χρησιμοποιείτε μια ισχυρή βιβλιοθήκη OAuth2 για τη γλώσσα σας, η οποία θα αναλάβει όλη τη δύσκολη δουλειά για εσάς. Τα παραδείγματά μας θα δείξουν τη βασικότερη χρήση από τη γραμμή εντολών με curl.

Staging

curl -X POST https://staging-iam.wink.travel/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_SECRET_KEY>"

Production

curl -X POST https://iam.wink.travel/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_SECRET_KEY>"

Αυτό θα επιστρέψει ένα access token, μαζί με άλλα δεδομένα απόκρισης OAuth2:

{
  "access_token": "abc123"
}

Όταν κάνετε κλήση σε οποιοδήποτε από τα endpoints μας, συμπεριλάβετε τα εξής στην κεφαλίδα:

Wink-Version = 2.0 Τελευταία - Δείτε τα API docs μας για άλλες διαθέσιμες εκδόσεις.
Authorization = Bearer ${access_token} Εισάγετε το access token σας.

Scopes

Ένα scope είναι μια άδεια που φέρει το access token σας. Όταν ζητάτε ένα token, περνάτε μια λίστα scopes διαχωρισμένη με κενά στο παράμετρο scope, και το token μπορεί να έχει πρόσβαση μόνο στις περιοχές που καλύπτουν αυτά τα scopes. Με το grant client_credentials ορίζετε τα scopes στο αίτημα token — δείτε τα παραδείγματα curl παραπάνω και το Postman walkthrough.

Τα scopes ονομάζονται section.action, όπου η ενέργεια είναι μία από:

read — προβολή πόρων (ασφαλείς αιτήσεις GET)
write — δημιουργία και ενημέρωση πόρων (POST / PUT / PATCH)
remove — διαγραφή πόρων (DELETE)

Η Wink ομαδοποιεί τις άδειες ανά λειτουργική περιοχή. Ζητήστε μόνο τα scopes που χρειάζεται η ενσωμάτωσή σας:

Ομάδα scope	Scopes	Τι ξεκλειδώνουν	Κίνδυνος
Account	`account.read` `account.write` `account.remove`	Διαχείριση οντοτήτων, μελών ομάδας, ρυθμίσεων, εφαρμογών	Χαμηλός–Μέτριος
Inventory	`inventory.read` `inventory.write` `inventory.remove`	Ακίνητα, τύποι δωματίων, τιμοκαταλόγοι, τιμές, πρόσθετα, διαθεσιμότητα, δραστηριότητες, αξιοθέατα	Χαμηλός–Μέτριος
Booking	`booking.read` `booking.write` `booking.remove`	Αναζήτηση, προβολή, δημιουργία, ακύρωση και επιστροφή κρατήσεων· ολοκλήρωση αγοράς· πολιτικές ακύρωσης	Χαμηλός–Μέτριος
Marketing	`marketing.read` `marketing.write` `marketing.remove`	Καμπάνιες, προνόμια, κανάλια πωλήσεων, WinkLinks, διαχειριζόμενα social, loyalty	Χαμηλός–Μέτριος
Content	`content.read` `content.write` `content.remove`	Περιγραφές ακινήτων, κριτικές, μέσα, χάρτες, green-index	Χαμηλός–Μέτριος
Analytics	`analytics.read` `analytics.write` `analytics.remove`	Αναφορές και αναλύσεις — έσοδα, πίνακες κατάταξης	Χαμηλός–Μέτριος
Integrations	`integrations.read` `integrations.write` `integrations.remove`	Channel managers, εξωτερικά συστήματα κρατήσεων, Google Hotel, endpoints ειδοποιήσεων, συγχρονισμός κρατήσεων	Χαμηλός–Μέτριος
Payment	`payment.read` `payment.write` `payment.remove`	Επεξεργασία πληρωμών, Stripe, Revolut, πληρωμές, συνδρομές	Μέτριος–Υψηλός
Accounting	`accounting.read` `accounting.write` `accounting.remove`	Λογιστική, κατάστιχο αναλήψεων, συμφωνίες	Μέτριος–Υψηλός
MCP	`mcp.read` `mcp.write` `mcp.remove`	Ανοίγει το MCP transport (`/mcp`) για AI agents	Χαμηλός–Μέτριος

Μερικά πράγματα που πρέπει να έχετε υπόψη:

Ζητήστε το ελάχιστο. Ζητήστε μόνο τα scopes που χρησιμοποιεί πραγματικά η ενσωμάτωσή σας — ένα token με ευρύτερη πρόσβαση από την αναγκαία έχει μεγαλύτερη έκταση ζημιάς αν διαρρεύσει.
Άγνωστα scopes απορρίπτονται. Η αίτηση για scope που η εφαρμογή σας δεν έχει καταχωρηθεί ή που δεν υπάρχει αποτυγχάνει κατά την έκδοση token.
Το mcp.* είναι μόνο για πελάτες AI-agent. Το χρειάζεστε για να ανοίξετε το MCP transport· δεν απαιτείται για κανονικές κλήσεις REST API. Δείτε το Model Context Protocol.