דלגו לתוכן
Wink

REST ו-gRPC

Wink מציגה שני פרוטוקולים. באיזה מהם תשתמש תלוי באיזו API אתה משתלב.

פרוטוקולסכימהתיעוד
רוב ה-APIs של WinkREST על HTTPSOpenAPI 3כל קבוצה תחת API בסרגל הצדדי
Partner Integrator APIgRPC על HTTP/2Protocol BuffersPartner

יצירת לקוח REST

Section titled “יצירת לקוח REST”

כל קבוצת API מפרסמת מסמך OpenAPI 3. הפנה כל מחולל OpenAPI אליו ותקבל לקוח טיפוסי בשפתך.

Terminal window
# המפרט של כל קבוצה זמין להורדה באתר זה: /api/downloads/<group>.json
curl -o wink-extranet.json https://wink.travel/api/downloads/extranet.json


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

מחוללי OpenAPI לפי שפה

יצירת לקוח gRPC

Section titled “יצירת לקוח gRPC”

Partner Integrator API הוא gRPC. אתה יוצר לקוח מתוך סכימת .proto, ש-Wink מפרסמת בשתי דרכים:

  • Server reflection — השרת מתאר את עצמו, כך שכלים כמו grpcurl, Postman ו-Insomnia יכולים לגלות את הסכימה בזמן ריצה ללא צורך בקבצים להורדה. Reflection דורש את אותו אסימון bearer כמו כל קריאה אחרת.
  • קבצי .proto, אם אתה מעדיף לכלול את הסכימה וליצור את הלקוח מראש.
Terminal window
# גלה את הסכימה משרת פעיל (מאומת).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# לאחר מכן צור לקוח — כאן Go; כל שפה נתמכת עובדת באותה צורה.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

הקריאות נושאות את אסימון ה-bearer שלך בכותרת המטא-דאטה authorization, בדיוק כמו ש-REST נושא אותו בכותרת Authorization. שגיאות מגיעות כקוד סטטוס gRPC בטריילרים של התגובה במקום כקוד סטטוס HTTP — הפניה ל-Partner מפרטת את הסטטוסים שעליך לצפות להם.

התחלות מהירות ב-gRPC לפי שפה

מה זה gRPC?

או תן לשרת MCP לכתוב את זה

Section titled “או תן לשרת MCP לכתוב את זה”

אם אתה משתמש בעוזר קידוד מבוסס AI, שרת MCP שלנו הוא הדרך המהירה ביותר. הוא מציג את APIs של Wink ככלים שהעוזר שלך יכול לקרוא ולהבין, כך שבמקום ליצור לקוח שלם ולמצוא את נקודות הקצה בעצמך, אתה מתאר מה אתה בונה ומקבל קוד אינטגרציה המותאם לכך.

הגדר את שרת MCP של Wink

קריאה נוספת

Section titled “קריאה נוספת”