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

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

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

مكالمة 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

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

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

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

الطبقة المجانية

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

• حد المعدل — 30 طلبًا في الدقيقة، مع دفعة 60 طلبًا. يتم امتصاص الارتفاعات القصيرة فوق المعدل المستمر بواسطة رصيد الدفعة. إذا تجاوزته، ترد الواجهة بـ HTTP 429 (طلبات كثيرة جدًا) وتطبق توقفًا لمدة 5 دقائق قبل أن يستأنف مفتاحك تقديم الحركة. توقف وحاول مرة أخرى بعد فترة التوقف بدلاً من الضغط على نقطة النهاية.
• الحصة الشهرية — 10,000 طلب لكل شهر تقويمي. بمجرد الوصول إلى الحد الشهري، تعيد الواجهة HTTP 429 لبقية الشهر — توقف نهائي — مع رسالة تدعوك للاشتراك في الطبقة المدفوعة للاستمرار. يتم إعادة تعيين العداد في بداية الشهر التقويمي التالي.

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

الطبقة المدفوعة

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

• الطلبات المقاسة — 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 مللي ثانية — ودعم أولوية قائم على شدة المشكلة.

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

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

تحدد اتفاقية مستوى الخدمة هذه (“SLA”) التزام التوفر، ائتمانات الخدمة، وأهداف الدعم التي تقدمها Wink (“Wink”، “نحن”، “لنا”) للعميل (“العميل”، “أنت”) لواجهة برمجة تطبيقات الشريك المعتمدة من Wink (“Partner API” أو “الخدمة”) على الطبقات التي يُذكر فيها تطبيق SLA. تُدمج هذه الاتفاقية في وتحكمها الاتفاقية بينك وبين Wink التي من خلالها تصل إلى واجهة برمجة تطبيقات الشريك (“الاتفاقية”)، وتطبق طالما تحافظ على اشتراك 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 الخاص بك. تبقى الأقسام التي بطبيعتها يجب أن تبقى بعد الإنهاء — بما في ذلك الأهلية المكتسبة ولكن غير المطالب بها لائتمانات الخدمة، تحديد المسؤولية، والتعريفات — سارية.