דלגו לתוכן
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
# המפרט עבור קבוצה מוגש לצד דף ההפניה שלה.
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

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 “קריאה נוספת”