ממשק API לשותפים
ממשק ה-API של Wink לשותפים הוא הדרך המאומתת, בעלת קצב העברה גבוה יותר, עבור אינטגרטורים לשאול מלאי נסיעות שניתן להזמין — אותו מלאי שמניע את הווידג’טים הניתנים להטמעה ואת נקודות הגלישה הציבוריות, המוצגים כממשק תכנותי מדרגה ראשונה. בעוד שה-Web Components החינמיים ונקודות הגלישה הציבוריות מיועדים להטמעה קלה ופונה לאדם, ממשק ה-API לשותפים בנוי למערכות שמחפשות, מחשבות מחירים ומבצעות הזמנות בקנה מידה גדול. הגישה מאומתת לכל אינטגרטור ומחושבת לפי שימוש, כך שתשלמו רק על התעבורה שאתם אכן שולחים.
תוכניות ותמחור
Section titled “תוכניות ותמחור”קריאת API אחת = בקשה אחת. שימוש מחושב מחויב לפי 1,000 בקשות.
| חינמי | בתשלום | ארגוני | |
|---|---|---|---|
| מחיר | $0 | מבוסס שימוש | צרו קשר |
| מתאים ל | הערכה ואינטגרציות בנפח נמוך | תשלום לפי שימוש בקצב גבוה בקנה מידה | נפח מותאם ותנאים משא ומתן |
| בקשות לדקה | 30 (פיצוץ של 60) | ללא הגבלה | ללא הגבלה |
| בקשות לחודש | 10,000 | ללא הגבלה | ללא הגבלה |
| זמן תגובה API (P95) | — | מתחת ל-500 מ”ש | מתחת ל-500 מ”ש |
| מחיר ל-1,000 בקשות | חינם | $1.00 | מותאם אישית |
| חיוב על חריגה של יחס חיפוש להזמנה (לכל 1,000 חיפושים מעבר ל-5,000:1) | — | $2.00 | מותאם אישית |
| תגובת מגבלת קצב | 429 (השהיה / עצירה חודשית) | אין | אין |
| הסכם רמת שירות | — | ✓ | ✓ |
| תמיכה בעדיפות | — | ✓ | ✓ |
| הטמעה ייעודית | — | — | ✓ |
קבל מפתח API · התחל חיוב לפי שימוש · צור קשר עם המכירות
הפניה ל-API
Section titled “הפניה ל-API”שני ממשקי OpenAPI מספקים מלאי שניתן להזמין, והם מתאימים לשני הרמות שלמעלה:
- חינמי — API לצרכן / מנוע הזמנות (
/api/public/**): אנונימי, פונה לדפדפן ולווידג’טים. עיין בהפניה למנוע ההזמנות → - בתשלום — API לאינטגרטור שותף (
/api/partner/**): מאומת, מחושב לפי שימוש, בנוי לאינטגרציה בין שרתים בקנה מידה גדול. עיין בהפניה לאינטגרטור →
כיצד פועל השימוש והמגבלות
Section titled “כיצד פועל השימוש והמגבלות”רמת חינמי
Section titled “רמת חינמי”רמת החינמי מיועדת לאפשר לכם לבנות, לבדוק ולהפעיל תעבורה יצרנית מתונה ללא עלות.
- מגבלת קצב — 30 בקשות לדקה, עם פיצוץ של 60 בקשות. זינוקים קצרים מעל הקצב המתמשך נספגים בהקצאת הפיצוץ. אם תחרגו, ה-API יגיב ב-HTTP 429 (יותר מדי בקשות) ויחיל השהיה של 5 דקות לפני שמפתח ה-API שלכם יחזור לשרת תעבורה. נסוגו ונסו שוב לאחר חלון ההשהיה במקום להקשות על נקודת הקצה.
- מכסת חודשית — 10,000 בקשות לחודש קלנדרי. ברגע שתגיעו לתקרה החודשית, ה-API יחזיר HTTP 429 לשארית החודש — עצירה מוחלטת — יחד עם הודעה המזמינה אתכם להירשם לרמת התשלום כדי להמשיך. המונה מתאפס בתחילת החודש הקלנדרי הבא.
רמת החינמי אינה כוללת הסכם רמת שירות או תמיכה בעדיפות.
רמת בתשלום
Section titled “רמת בתשלום”רמת התשלום מסירה את התקרה החודשית ואת ההשהיות של מגבלת הקצב, ומחייבת אתכם רק על מה שאתם משתמשים.
-
בקשות מחושבות — $1.00 לכל 1,000 בקשות. אין תקרה חודשית ואין הגבלת קצב בשימוש רגיל; אתם מחויבים לפי הנפח בפועל.
-
חיוב על חריגה של יחס חיפוש להזמנה — $2.00 לכל 1,000 חיפושים עודפים. כדי לשמור על מלאי בריא, אנו מחשבים את היחס בין חיפושים (“חיפושים”) להזמנות מאושרות. אתם זכאים ל-5,000 חיפושים לכל הזמנה לפני שהחיוב על חריגה חל. החיפושים העודפים מחושבים כך:
excess = max(0, looks − bookings × 5,000)החיוב על החריגה הוא $2.00 לכל 1,000 חיפושים עודפים. אינטגרציות שממירות טוב כמעט ולא גורמות לחריגה; התשלום חל רק על תעבורה שמחפשת הרבה יותר ממה שהיא מזמינה.
רמת התשלום כוללת את הסכם רמת השירות המתואר למטה — התחייבות לזמינות של 99.9% ומטרת זמן תגובה P95 מתחת ל-500 מ”ש — ותמיכה בעדיפות, מבוססת חומרת הבעיה.
הסכם רמת שירות
Section titled “הסכם רמת שירות”תאריך תחולה: 5 ביולי 2026 · גרסה 1.0
הסכם רמת השירות הזה (“SLA”) מגדיר את התחייבות הזמינות, קרדיטים לשירות, ויעדי התמיכה ש-Wink (“Wink”, “אנחנו”, “לנו”) מספק ללקוח (“לקוח”, “אתה”) עבור ממשק ה-API המאומת של Wink Partner (“Partner API” או “השירות”) ברמות שבהן מצוין כי ה-SLA חל. הסכם זה משולב ומנוהל על פי ההסכם בינך לבין Wink שבמסגרתו אתה ניגש ל-Partner API (“ההסכם”), ותקף כל עוד אתה שומר על מנוי Partner API בתשלום ובמצב תקין. מונחים עם אותיות גדולות שלא הוגדרו כאן מקבלים את המשמעות שניתנה להם בהסכם.
1. הגדרות
Section titled “1. הגדרות”- “זמינות” פירושה התקופות שבהן Partner API זמין לקבל ולהגיב בהצלחה לבקשות מאומתות ומנוסחות כראוי.
- “אי זמינות” פירושה כל תקופה, הנמדדת בדקות, שבה Partner API נכשל להגיב בהצלחה לבקשות מאומתות ומנוסחות כראוי, למעט תקופות הכלולות בחריגות המפורטות בסעיף 4. שגיאות מבודדות המשפיעות על חלק זניח מהבקשות אינן, בפני עצמן, אי זמינות.
- “אחוז זמינות חודשי” פירושו, עבור חודש קלנדרי נתון, סך כל הדקות בחודש פחות סך דקות אי הזמינות, חלקי סך כל הדקות בחודש, מבוטא באחוזים.
- “תחזוקה מתוזמנת” פירושה תחזוקה מתוכננת של השירות שעליה Wink הודיעה מראש בהתאם לסעיף 4.
- “קרדיט שירות” פירושו זיכוי, המחושב כאחוז מהתשלומים ששולמו או שיש לשלם על Partner API בחודש הקלנדרי הנפגע, המיושם כנגד תשלומים עתידיים עבור Partner API כפתרון הבלעדי והיחיד לכישלון לעמוד בהתחייבות הזמינות.
- “זמן תגובה” פירושו הזמן שחלף מרגע קבלת Wink בקשה מאומתת ומנוסחת כראוי בגבול השירות של Wink ועד לנקודה שבה Wink מתחיל להחזיר את התגובה, ללא זמן העברה ברשת וכל זמן בצד הלקוח שאינו בשליטת Wink.
2. התחייבות לזמינות וביצועים
Section titled “2. התחייבות לזמינות וביצועים”Wink תשתמש במאמצים סבירים מסחרית כדי להבטיח ש-Partner API יהיה זמין ב-אחוז זמינות חודשי של לפחות 99.9% במהלך כל חודש קלנדרי בתקופת ההסכם (“התחייבות הזמינות”). התחייבות הזמינות נמדדת בגבול השירות של Wink ומוצאת מחוץ לגורמים שאינם בשליטת Wink באופן סביר, כולל אלה המתוארים בסעיף 4. מערכות הניטור של Wink הן המקור הרשמי למדידת אחוז הזמינות החודשי וזמן התגובה.
Wink גם שואפת ל-זמן תגובה ברבעון ה-95 (P95) מתחת ל-500 מילישניות עבור בקשות מאומתות ומנוסחות כראוי, הנמדדות בגבול השירות של Wink במהלך כל חודש קלנדרי (“מטרת הביצועים”). מטרת הביצועים אינה כוללת את הגורמים המתוארים בסעיף 4, בקשות שמחזירות שגיאות ברמת היישום שנגרמו על ידי הבקשה עצמה, ובקשות אצווה גדולות או מורכבות במיוחד. מטרת הביצועים היא יעד שירות; קרדיטי השירות בסעיף 3 חלים על כישלונות לעמוד ב-התחייבות הזמינות והם הפתרון הבלעדי והיחיד למחסור בזמינות.
3. קרדיטי שירות
Section titled “3. קרדיטי שירות”אם אחוז הזמינות החודשי יורד מתחת להתחייבות הזמינות בכל חודש קלנדרי, ייתכן שתהיה זכאי לקרדיט שירות המחושב כאחוז מתשלומי Partner API ששולמו או שיש לשלם עבורך באותו חודש, לפי הטבלה הבאה:
| אחוז זמינות חודשי | קרדיט שירות |
|---|---|
| מתחת ל-99.9% אך מעל או שווה ל-99.0% | 10% |
| מתחת ל-99.0% אך מעל או שווה ל-95.0% | 25% |
| מתחת ל-95.0% | 50% |
- תביעה לקרדיט. כדי לקבל קרדיט שירות עליך להגיש תביעה בכתב ל-Wink בתוך שלושים (30) ימים מסוף החודש הקלנדרי שבו אירעה הירידה. התביעה חייבת לכלול את התאריכים והשעות של כל אירוע אי זמינות שאתה תובע וכל לוגים או ראיות תומכות הזמינות לך סביר. תביעות המוגשות לאחר חלון זה אינן זכאיות.
- צורת הקרדיט. קרדיטי שירות מאושרים מיושמים כנגד תשלומים עתידיים עבור Partner API ואינם בעלי ערך כספי. הם אינם החזרים ולא ישולמו אלא אם כן נדרש על פי חוק.
- קרדיט מקסימלי. סך כל קרדיטי השירות שיינתנו עבור חודש קלנדרי יחיד לא יעלה על 50% מתשלומי Partner API ששולמו או שיש לשלם עבורך באותו חודש.
- פתרון בלעדי ויחיד. קרדיטי השירות הם הפתרון הבלעדי והיחיד שלך לכל כישלון של Wink לעמוד בהתחייבות הזמינות או כל מחסור אחר בזמינות Partner API.
4. חריגות
Section titled “4. חריגות”התחייבות הזמינות וכל קרדיטי השירות הנובעים ממנה אינם חלים, ואי זמינות אינה כוללת, כל אי זמינות, השעיה, ירידה באיכות או בעיית ביצועים הנובעים מ-או קשורים ל:
- תחזוקה מתוזמנת שעליה Wink הודיעה מראש, בתנאי שההודעה ניתנה בזמן סביר מראש דרך ערוץ ש-Wink משתמשת בו בדרך כלל לתקשורת עם לקוחות;
- אירועי כוח עליון או סיבות אחרות שאינן בשליטת Wink באופן סביר, כולל אסונות טבע, פעולות ממשלה, כשלי רשת או שירותים, ותקיפות מניעת שירות או תקיפות זדוניות אחרות;
- בעיות הנגרמות על ידי פעולות או מחדלים שלך, הציוד, התוכנה או הרשת שלך, או על ידי כל שירות, מוצר או ספק של צד שלישי שאינו בשליטת Wink ישירה;
- שימוש לרעה בשירות או הפרת ההסכם, ה-SLA הזה, תנאי השימוש המקובלים, או מגבלות קצב חלות, כולל תעבורה ש-Wink סבירה לקבוע שהיא מופרזת, שימוש אוטומטי לרעה, או הונאה; ו
- כל השעיה או הפסקת גישה שלך שנעשו כדין על פי ההסכם, כולל השעיה בגין אי תשלום.
5. יעדי תמיכה ותגובה
Section titled “5. יעדי תמיכה ותגובה”Wink מספקת תמיכה עבור Partner API בשעות עבודה רגילות, למעט חגים מקומיים. Wink תשתמש במאמצים סבירים מסחרית להכיר בבקשות תמיכה שהוגשו כראוי בתוך זמני תגובה יעד הבאים, בהתבסס על חומרת הבעיה שאתה מגדיר ו-Wink מאשרת סביר:
| חומרה | תיאור | זמן תגובה ראשוני יעד |
|---|---|---|
| חומרה 1 — קריטי | Partner API לא פעיל או בלתי שמיש בייצור ללא פתרון חלופי. | 4 שעות |
| חומרה 2 — משמעותי | תכונה משמעותית נפגמת או ירודה; קיים פתרון חלופי. | יום עסקים אחד |
| חומרה 3 — מינורי | שאלות כלליות, בעיות קטנות, או בקשות תכונה. | יומיים עסקים |
זמני התגובה היעדיים מתארים מתי Wink שואפת ליצור מגע ראשוני; הם אינם הבטחות לזמן פתרון. תמיכה בעדיפות ויעדי חומרה חלים ברמות שבהן מצוין שהם כלולים.
6. נתונים ואבטחה
Section titled “6. נתונים ואבטחה”Wink שומרת על אמצעים מנהליים, טכניים וארגוניים סבירים מסחרית שנועדו להגן על סודיות, שלמות וזמינות הנתונים המעובדים דרך Partner API, ובוחנת אמצעים אלה מעת לעת. עיבוד הנתונים האישיים של Wink מנוהל על פי מדיניות הפרטיות וכל תנאי עיבוד נתונים בהסכם. אתה נשאר אחראי לאבטחת אישורי ה-API שלך, לשימוש חוקי בכל נתון שאתה מושך, ולהודיע ל-Wink במהירות על כל חשד לפגיעה באישורים.
7. הגבלת אחריות
Section titled “7. הגבלת אחריות”קרדיטי השירות הם הפתרון הבלעדי והיחיד לכל אי זמינות או כישלון לעמוד בהתחייבות הזמינות, ומסופקים במקום כל אחריות אחרת הנובעת מכישלון כזה. למעט כפי שמוצהר במפורש ב-SLA זה, Partner API מסופק “כפי שהוא”. במידה המרבית המותרת על פי חוק, האחריות הכוללת של Wink הנובעת או הקשורה לשירות מוגבלת כפי שמפורט בהסכם, ו-Wink אינה אחראית לנזקים עקיפים, מקריים, מיוחדים, תוצאתיים או עונשיים, או לאובדן רווחים, הכנסות, נתונים או מוניטין, גם אם הונחה על אפשרות נזקים כאלה.
8. תקופה, שינויים וסיום
Section titled “8. תקופה, שינויים וסיום”SLA זה תקף כל עוד יש לך מנוי Partner API פעיל ברמה שבה מצוין כי ה-SLA חל. Wink רשאית לעדכן SLA זה מעת לעת; שינויים מהותיים יועברו דרך ערוץ ש-Wink משתמשת בו בדרך כלל לתקשורת עם לקוחות, והשימוש המתמשך ב-Partner API לאחר כניסת העדכון לתוקף מהווה הסכמה ל-SLA המעודכן. SLA זה מסתיים אוטומטית עם סיום או פקיעת ההסכם או מנוי Partner API שלך. סעיפים שבאופיים צריכים לשרוד את הסיום — כולל זכאות לקרדיט שירות שנצבר אך לא תבע, הגבלת אחריות והגדרות — יישארו בתוקף.