واجهة برمجة تطبيقات الشريك

تُعد واجهة برمجة تطبيقات الشريك من Wink Partner API الطريقة المعتمدة والأعلى قدرة لاستعلام المخزون القابل للحجز للسفر — نفس العرض الذي يدعم أدواتنا القابلة للتضمين ونقاط النهاية العامة للتصفح، معروضة كواجهة برمجية من الدرجة الأولى. حيث أن مكونات الويب المجانية ونقاط النهاية العامة للتصفح مخصصة للتضمين الخفيف الموجه للبشر، تم بناء واجهة برمجة تطبيقات الشريك للأنظمة التي تبحث، تسعر، وتحجز على نطاق واسع. يتم التحقق من الوصول لكل متكامل ويتم الفوترة حسب الاستخدام، لذا تدفع فقط مقابل حركة المرور التي ترسلها فعليًا.

الخطط والتسعير

يتم قياس الاستخدام بوحدات ليالي الفنادق: فندق واحد يتم تسعيره لإقامة ليلة واحدة — وليس لكل استدعاء API. البحث الذي يعيد 20 فندقًا لإقامة 3 ليالٍ يعادل 60 ليلة فندق من طلب واحد. استثناءات المكالمات هي المحتوى والبحث (البحث عن الوجهة والإكمال التلقائي): كل منها يكلف وحدة واحدة لكل مكالمة، مهما كانت النتيجة. نقاط نهاية الحساب مجانية. التسعير هو المصدر الرسمي للسعر.

	مجاني	مدفوع	مؤسسي
السعر	0 دولار	حسب الاستخدام	تواصل معنا
الأفضل لـ	التقييم والتكاملات منخفضة الحجم	الدفع حسب الاستخدام على نطاق واسع	حجم مخصص وشروط متفاوض عليها
الوحدات شهريًا	10,000	غير محدود	غير محدود
زمن استجابة API (P95)	—	أقل من 500 مللي ثانية	أقل من 500 مللي ثانية
السعر لكل وحدة (ليلة فندق)	مجاني	0.0001 دولار	مخصص
الاستجابة عند الوصول للحد الشهري	429 حتى الأول من الشهر التالي (UTC)	يتم الفوترة، لا يتم الحظر	حسب الاتفاق
اتفاقية مستوى الخدمة	—	✓	✓
دعم أولوية	—	✓	✓
تدريب مخصص	—	—	✓

احصل على مفتاح API · ابدأ الفوترة حسب الاستخدام · تواصل مع المبيعات

مرجع API

تخدم واجهتان مخزون الحجز، وتطابقان المستويين أعلاه:

• مجاني — API المستهلك / محرك الحجز (REST، /api/public/**): مجهول، موجه للمتصفح والأدوات. تصفح مرجع محرك الحجز →
• مدفوع — API متكامل الشريك (gRPC، wink.partner.v1): معتمد، مقاس حسب الاستخدام، مبني للتكامل خادم إلى خادم على نطاق واسع. تصفح مرجع المتكامل →

واجهة برمجة تطبيقات متكامل الشريك هي gRPC وليست REST. تستدعيها باستخدام عميل مولد عبر HTTP/2 على partner.wink.travel:443، مع تمرير رمز حامل الحساب الذي تستدعيه:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

توثق صفحة المرجع أعلاه كل خدمة، رسالة، وحالة خطأ، كما أن المخطط متاح أيضًا في وقت التشغيل من خلال انعكاس الخادم، لذا يكتشفها grpcurl وPostman وInsomnia دون الحاجة لتنزيل أي شيء.

إذا كنت تفضل توليد عميل مسبقًا، فإن ملفات المصدر .proto منشورة على github.com/wink-travel/partner-api-proto.

كيفية عمل الاستخدام والحدود

المستوى المجاني

تم تصميم المستوى المجاني للسماح لك بالبناء، الاختبار، وتشغيل حركة إنتاج معتدلة بدون تكلفة.

• لا يوجد حد منشور لكل دقيقة. تراقب Wink معدلات الطلب وقد تطبق حدود استخدام عادلة لحماية الخدمة. إذا تلقيت HTTP 429 (طلبات كثيرة جدًا)، انتظر عدد الثواني في رأس Retry-After قبل إعادة المحاولة.
• البدل الشهري — 10,000 وحدة لكل شهر تقويمي. يُمنح البدل لكل حساب ويُعاد تعيينه في الأول من كل شهر (UTC). بمجرد الوصول إليه، يتلقى الحساب الذي لم يشترك في الفوترة حسب الاستخدام HTTP 429 حتى الأول من الشهر التالي — توقف صارم، مع رأس Retry-After ورسالة تدعوك للاشتراك في المستوى المدفوع. يستمر الحساب المشترك في العمل ويتم فوترة الاستخدام الزائد.

المستوى المجاني لا يشمل اتفاقية مستوى الخدمة أو دعم الأولوية.

المستوى المدفوع

يزيل المستوى المدفوع الحد الشهري ويفوترك فقط مقابل ما تستخدمه.

• ليالي الفنادق المقاسة — 0.0001 دولار لكل ليلة فندق. لا يوجد حد شهري؛ يتم الفوترة حسب الحجم الفعلي. قد تطبق Wink حدود استخدام عادلة لحماية الخدمة. يتم فوترة مكالمات البحث والمخزون لكل ليلة فندق مسعرة؛ ومكالمات المحتوى والبحث بوحدة واحدة لكل منها، لذا تجميع طلباتك يقلل الفاتورة.

يشمل المستوى المدفوع اتفاقية مستوى الخدمة الموضحة أدناه — التزام بنسبة تشغيل 99.9% وهدف زمن استجابة P95 أقل من 500 مللي ثانية — ودعم أولوية قائم على شدة المشكلة.

اتفاقية مستوى الخدمة

تاريخ السريان: 5 يوليو 2026 · الإصدار 1.0

تحدد اتفاقية مستوى الخدمة هذه (“SLA”) التزام التوفر، أرصدة الخدمة، وأهداف الدعم التي تقدمها Wink (“Wink”، “نحن”) للعميل (“العميل”، “أنت”) لواجهة برمجة تطبيقات الشريك المعتمدة من Wink (“Partner API” أو “الخدمة”) على المستويات التي يُذكر فيها تطبيق SLA. تُدمج هذه الاتفاقية في وتحكمها الاتفاقية بينك وبين Wink التي من خلالها تصل إلى Partner API (“الاتفاقية”)، وتطبق طالما تحافظ على اشتراك Partner API نشط ومدفوع بحالة جيدة. المصطلحات المكتوبة بحروف كبيرة وغير المعرفة هنا تحمل المعاني المعطاة لها في الاتفاقية.

1. التعريفات

1. “وقت التشغيل” يعني الفترات التي تكون فيها واجهة برمجة تطبيقات الشريك متاحة لقبول والرد بنجاح على الطلبات المصاغة بشكل صحيح والمعتمدة.
2. “وقت التوقف” يعني أي فترة، مقاسة بالدقائق، تفشل فيها واجهة برمجة تطبيقات الشريك في الرد بنجاح على الطلبات المصاغة بشكل صحيح والمعتمدة، باستثناء أي فترة تقع ضمن الاستثناءات المحددة في القسم 4. الأخطاء المعزولة التي تؤثر على جزء ضئيل من الطلبات ليست، بحد ذاتها، وقت توقف.
3. “نسبة وقت التشغيل الشهري” تعني، لشهر تقويمي معين، إجمالي عدد الدقائق في ذلك الشهر مطروحًا منه دقائق وقت التوقف، مقسومًا على إجمالي عدد الدقائق في ذلك الشهر، معبرًا عنها كنسبة مئوية.
4. “الصيانة المجدولة” تعني الصيانة المخططة للخدمة التي قدمت Wink إشعارًا مسبقًا بها وفقًا للقسم 4.
5. “رصيد الخدمة” يعني رصيدًا، محسوبًا كنسبة مئوية من الرسوم المدفوعة أو المستحقة عليك لواجهة برمجة تطبيقات الشريك في الشهر التقويمي المتأثر، يُطبق مقابل رسوم Partner API المستقبلية كعلاج وحيد وحصري لفشل في الوفاء بالتزام وقت التشغيل.
6. “زمن الاستجابة” يعني الوقت المنقضي بين استلام Wink لطلب مصاغ بشكل صحيح ومعتمد عند حدود خدمة Wink والنقطة التي تبدأ فيها Wink بإرجاع الاستجابة، مع استثناء وقت النقل الشبكي وأي وقت على جانب العميل خارج سيطرة Wink.

2. التزام التوفر والأداء

ستبذل Wink جهودًا تجارية معقولة لجعل واجهة برمجة تطبيقات الشريك متاحة بنسبة وقت تشغيل شهري لا تقل عن 99.9% خلال كل شهر تقويمي من المدة (“التزام وقت التشغيل”). يُقاس التزام وقت التشغيل عند حدود خدمة Wink ويستثني أي عوامل خارج السيطرة المعقولة لـWink، بما في ذلك تلك الموضحة في القسم 4. أنظمة مراقبة Wink هي المصدر الرسمي لقياس نسبة وقت التشغيل الشهري وزمن الاستجابة.

تستهدف Wink أيضًا زمن استجابة في المئين الخامس والتسعين (P95) أقل من 500 مللي ثانية للطلبات الناجحة، المصاغة بشكل صحيح والمعتمدة، مقاسة عند حدود خدمة Wink خلال كل شهر تقويمي (“هدف الأداء”). يستثني هدف الأداء العوامل الموضحة في القسم 4، والطلبات التي تعيد أخطاء على مستوى التطبيق ناتجة عن الطلب نفسه، والطلبات الكبيرة أو المعقدة بشكل غير عادي. هدف الأداء هو هدف خدمة؛ وتطبق أرصدة الخدمة في القسم 3 على حالات الفشل في الوفاء بـالتزام وقت التشغيل وهي العلاج الوحيد والحصري لنقص التوفر.

3. أرصدة الخدمة

إذا انخفضت نسبة وقت التشغيل الشهري عن التزام وقت التشغيل في أي شهر تقويمي، قد تكون مؤهلاً للحصول على رصيد خدمة محسوب كنسبة مئوية من رسوم Partner API المدفوعة أو المستحقة عليك لذلك الشهر، وفقًا للجدول التالي:

نسبة وقت التشغيل الشهري	رصيد الخدمة
أقل من 99.9% ولكن 99.0% أو أكثر	10%
أقل من 99.0% ولكن 95.0% أو أكثر	25%
أقل من 95.0%	50%

1. المطالبة بالرصيد. لتلقي رصيد خدمة يجب عليك تقديم مطالبة كتابية إلى Wink خلال ثلاثين (30) يومًا من نهاية الشهر التقويمي الذي حدث فيه النقص. يجب أن تتضمن المطالبة تواريخ وأوقات كل حادثة وقت توقف تدعيها وأي سجلات أو أدلة داعمة متاحة لك بشكل معقول. المطالبات المقدمة بعد هذه الفترة غير مؤهلة.
2. شكل الرصيد. تُطبق أرصدة الخدمة المعتمدة مقابل رسوم Partner API المستقبلية ولا قيمة نقدية لها. ليست استردادًا ولن تُدفع نقدًا إلا إذا طلب القانون ذلك.
3. الحد الأقصى للرصيد. لا تتجاوز إجمالي أرصدة الخدمة الممنوحة لأي شهر تقويمي واحد 50% من رسوم Partner API المدفوعة أو المستحقة عليك لذلك الشهر.
4. العلاج الوحيد والحصري. أرصدة الخدمة هي العلاج الوحيد والحصري لأي فشل من Wink في الوفاء بالتزام وقت التشغيل أو أي نقص آخر في توفر واجهة برمجة تطبيقات الشريك.

4. الاستثناءات

لا ينطبق التزام وقت التشغيل وأي أرصدة خدمة ناتجة عنه، ولا يشمل وقت التوقف، أي عدم توفر، تعليق، تدهور، أو مشكلة أداء تنشأ من أو تتعلق بـ:

1. الصيانة المجدولة التي قدمت Wink إشعارًا مسبقًا بها، بشرط أن يتم الإشعار بفترة معقولة مسبقًا عبر قناة تستخدمها Wink عادة للتواصل مع العملاء؛
2. أحداث القوة القاهرة أو أسباب أخرى خارجة عن السيطرة المعقولة لـWink، بما في ذلك الكوارث الطبيعية، أعمال الحكومة، فشل الشبكة أو المرافق، وهجمات الحرمان من الخدمة أو الهجمات الخبيثة الأخرى؛
3. مشكلات ناجمة عن أفعالك أو إغفالاتك، معداتك، برامجك، أو شبكتك، أو عن أي خدمة، منتج، أو مزود طرف ثالث ليس تحت السيطرة المباشرة لـWink؛
4. إساءة استخدامك للخدمة أو انتهاكك للاتفاقية، هذه الاتفاقية، شروط الاستخدام المقبول، أو حدود المعدل المطبقة، بما في ذلك حركة المرور التي تحددها Wink بشكل معقول على أنها مفرطة، إساءة استخدام آلية، أو احتيالية؛ و
5. أي تعليق أو إنهاء لوصولك تم بشكل صحيح بموجب الاتفاقية، بما في ذلك التعليق بسبب عدم الدفع.

5. الدعم وأهداف الاستجابة

توفر Wink الدعم لواجهة برمجة تطبيقات الشريك خلال ساعات العمل الرسمية، باستثناء العطلات الرسمية المحلية. ستبذل Wink جهودًا تجارية معقولة للاعتراف بطلبات الدعم المقدمة بشكل صحيح ضمن أوقات الاستجابة المستهدفة التالية، بناءً على شدة المشكلة التي تحددها وتؤكدها Wink بشكل معقول:

الشدة	الوصف	الاستجابة الأولية المستهدفة
شدة 1 — حرجة	واجهة برمجة تطبيقات الشريك متوقفة أو غير قابلة للاستخدام في الإنتاج بدون حل بديل.	4 ساعات
شدة 2 — كبيرة	ميزة مهمة متأثرة أو متدهورة؛ يوجد حل بديل.	يوم عمل واحد
شدة 3 — بسيطة	أسئلة عامة، مشكلات بسيطة، أو طلبات ميزات.	يومي عمل

تصف أوقات الاستجابة المستهدفة متى تهدف Wink إلى إجراء الاتصال الأولي؛ وليست ضمانات لوقت الحل. ينطبق دعم الأولوية وأهداف الشدة على المستويات التي يُذكر فيها تضمينها.

6. البيانات والأمان

تحافظ Wink على تدابير إدارية وتقنية وتنظيمية معقولة تجاريًا مصممة لحماية سرية وسلامة وتوفر البيانات المعالجة عبر واجهة برمجة تطبيقات الشريك، وتراجع هذه التدابير دوريًا. تخضع معالجة Wink للبيانات الشخصية لسياسة الخصوصية Privacy Policy وأي شروط معالجة بيانات في الاتفاقية. تظل مسؤولًا عن تأمين بيانات اعتماد API الخاصة بك، والاستخدام القانوني لأي بيانات تسترجعها، والإبلاغ الفوري إلى Wink عن أي اشتباه في اختراق بيانات الاعتماد.

7. تحديد المسؤولية

أرصدة الخدمة هي العلاج الوحيد والحصري لأي عدم توفر أو فشل في الوفاء بالتزام وقت التشغيل، وتُقدم بدلاً من أي مسؤولية أخرى ناشئة عن هذا الفشل. باستثناء ما هو منصوص عليه صراحة في هذه الاتفاقية، تُقدم واجهة برمجة تطبيقات الشريك “كما هي” دون ضمانات. إلى أقصى حد يسمح به القانون المعمول به، تقتصر مسؤولية Wink الإجمالية الناشئة عن أو المتعلقة بالخدمة كما هو محدد في الاتفاقية، ولا تتحمل Wink أي أضرار غير مباشرة، عرضية، خاصة، تبعية، أو عقابية، أو خسائر في الأرباح، الإيرادات، البيانات، أو السمعة، حتى لو تم إعلامها بإمكانية حدوث مثل هذه الأضرار.

8. المدة، التغييرات، والإنهاء

تطبق هذه الاتفاقية طالما لديك اشتراك Partner API نشط على مستوى يُذكر فيه تطبيق SLA. قد تقوم Wink بتحديث هذه الاتفاقية من وقت لآخر؛ سيتم إعلامك بالتغييرات الجوهرية عبر قناة تستخدمها Wink عادة للوصول إلى العملاء، ويشكل استمرار استخدام Partner API بعد سريان التحديث قبولًا للاتفاقية المحدثة. تنتهي هذه الاتفاقية تلقائيًا عند إنهاء أو انتهاء الاتفاقية أو اشتراك Partner API الخاص بك. تبقى الأقسام التي بطبيعتها يجب أن تبقى بعد الإنهاء — بما في ذلك الأهلية لأرصدة الخدمة المتراكمة غير المطالب بها، تحديد المسؤولية، والتعريفات — سارية.