Μετάβαση στο περιεχόμενο
Wink

REST και gRPC

Η Wink παρέχει δύο μεταφορές. Ποια θα χρησιμοποιήσετε εξαρτάται από το ποιο API ενσωματώνετε.

ΜεταφοράΣχήμαΤεκμηρίωση
Τα περισσότερα APIs της WinkREST μέσω HTTPSOpenAPI 3Οποιαδήποτε ομάδα κάτω από API στην πλαϊνή μπάρα
Partner Integrator APIgRPC μέσω HTTP/2Protocol BuffersPartner

Δημιουργία REST πελάτη

Ενότητα με τίτλο «Δημιουργία REST πελάτη»

Κάθε ομάδα API δημοσιεύει ένα έγγραφο OpenAPI 3. Δώστε σε οποιονδήποτε γεννήτορα OpenAPI το έγγραφο και θα λάβετε έναν τυποποιημένο πελάτη στη γλώσσα σας.

Terminal window
# Το spec για μια ομάδα σερβίρεται δίπλα στη σελίδα αναφοράς της.
curl -o wink-extranet.json https://api.wink.travel/v3/api-docs/extranet


npx @openapitools/openapi-generator-cli generate \
  -i wink-extranet.json -g typescript-fetch -o ./wink-client

Γεννήτορες OpenAPI ανά γλώσσα

Δημιουργία gRPC πελάτη

Ενότητα με τίτλο «Δημιουργία gRPC πελάτη»

Το Partner Integrator API είναι gRPC. Δημιουργείτε έναν πελάτη από το σχήμα .proto, το οποίο η Wink δημοσιεύει με δύο τρόπους:

  • Server reflection — ο server περιγράφει τον εαυτό του, ώστε εργαλεία όπως το grpcurl, Postman και Insomnia να μπορούν να ανακαλύψουν το σχήμα κατά την εκτέλεση χωρίς αρχεία για λήψη. Η reflection απαιτεί το ίδιο bearer token όπως και κάθε άλλη κλήση.
  • Τα αρχεία .proto, αν προτιμάτε να έχετε το σχήμα τοπικά και να δημιουργήσετε τον πελάτη εκ των προτέρων.
Terminal window
# Ανακαλύψτε το σχήμα από έναν τρέχοντα server (με αυθεντικοποίηση).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Έπειτα δημιουργήστε έναν πελάτη — εδώ Go; κάθε υποστηριζόμενη γλώσσα λειτουργεί με τον ίδιο τρόπο.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Οι κλήσεις μεταφέρουν το bearer token σας στην κεφαλίδα μεταδεδομένων authorization, ακριβώς όπως το REST το μεταφέρει στην κεφαλίδα Authorization. Τα σφάλματα επιστρέφονται ως κωδικός κατάστασης gRPC στα trailers της απόκρισης αντί για κωδικό HTTP — η αναφορά Partner απαριθμεί τους κωδικούς που πρέπει να περιμένετε.

Γρήγορα ξεκινήματα gRPC ανά γλώσσα

Τι είναι το gRPC;

Ή αφήστε τον MCP server να το γράψει

Ενότητα με τίτλο «Ή αφήστε τον MCP server να το γράψει»

Αν χρησιμοποιείτε έναν βοηθό κωδικοποίησης με AI, ο MCP server μας είναι η ταχύτερη διαδρομή. Παρέχει τα APIs της Wink ως εργαλεία που ο βοηθός σας μπορεί να καλέσει και να επεξεργαστεί, οπότε αντί να δημιουργήσετε έναν ολόκληρο πελάτη και να βρείτε τα endpoints μόνοι σας, περιγράφετε τι κατασκευάζετε και λαμβάνετε κώδικα ενσωμάτωσης προσαρμοσμένο σε αυτό.

Ρυθμίστε τον MCP server της Wink

Επιπλέον ανάγνωση

Ενότητα με τίτλο «Επιπλέον ανάγνωση»