Πιστοποίηση
Μια εφαρμογή σας παρέχει ένα Client ID και ένα Secret Key που χρειάζεστε για να δημιουργήσετε μια πιστοποιημένη συνεδρία OAuth2, την οποία μπορείτε να χρησιμοποιήσετε για να επικοινωνήσετε με τα APIs της Wink και της TripPay.
Ακολουθούν τα βήματα για να δημιουργήσετε μια πιστοποιημένη συνεδρία.
Βήμα 1. Ανάκτηση ενός access token στο staging ή στο περιβάλλον παραγωγής μας:
Πιθανότατα θα δουλεύετε με μια ισχυρή βιβλιοθήκη OAuth2 για τη γλώσσα σας, η οποία θα αναλάβει όλη τη δύσκολη δουλειά για εσάς.
Τα παραδείγματά μας θα δείξουν την πιο βασική χρήση από τη γραμμή εντολών χρησιμοποιώντας curl.
Staging
Ενότητα με τίτλο «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
Ενότητα με τίτλο «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 σας.
Ένα 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.read account.write account.remove | Διαχείριση οντοτήτων, μελών ομάδας, ρυθμίσεων, εφαρμογών | Χαμηλός–Μεσαίος |
| Απόθεμα | inventory.read inventory.write inventory.remove | Ιδιοκτησίες, τύποι δωματίων, τιμοκαταλόγοι, τιμές, πρόσθετα, διαθεσιμότητα, δραστηριότητες, αξιοθέατα | Χαμηλός–Μεσαίος |
| Κράτηση | booking.read booking.write booking.remove | Αναζήτηση, προβολή, δημιουργία, ακύρωση και επιστροφή κρατήσεων· ολοκλήρωση αγοράς· πολιτικές ακύρωσης | Χαμηλός–Μεσαίος |
| Μάρκετινγκ | marketing.read marketing.write marketing.remove | Καμπάνιες, προνόμια, κανάλια πωλήσεων, διαχείριση Link, διαχειριζόμενα social, loyalty | Χαμηλός–Μεσαίος |
| Περιεχόμενο | content.read content.write content.remove | Περιγραφές ιδιοκτησιών, κριτικές, μέσα, χάρτες, green-index | Χαμηλός–Μεσαίος |
| Αναλύσεις | analytics.read analytics.write analytics.remove | Αναφορές και αναλύσεις — έσοδα, πίνακες κατάταξης | Χαμηλός–Μεσαίος |
| Ενσωματώσεις | integrations.read integrations.write integrations.remove | Channel managers, εξωτερικά συστήματα κρατήσεων, Google Hotel, endpoints ειδοποιήσεων, συγχρονισμός κρατήσεων | Χαμηλός–Μεσαίος |
| Πληρωμές | payment.read payment.write payment.remove | Επεξεργασία πληρωμών, Stripe, Revolut, πληρωμές, συνδρομές | Μεσαίος–Υψηλός |
| Λογιστική | 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.
