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

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

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

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

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

مجاني — 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.

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

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

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

حد المعدل — 30 طلبًا في الدقيقة، مع دفعة 60 طلبًا. يتم امتصاص الارتفاعات القصيرة فوق المعدل المستمر بواسطة رصيد الدفعة. إذا تجاوزته، يستجيب API بـ HTTP 429 (طلبات كثيرة جدًا) ويطبق توقفًا لمدة 5 دقائق قبل استئناف مفتاحك لخدمة الحركة. توقف وأعد المحاولة بعد فترة التوقف بدلاً من الضغط على نقطة النهاية.
الحصة الشهرية — 10,000 طلب لكل شهر تقويمي. بمجرد الوصول إلى الحد الشهري، يعيد API 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 (“واجهة برمجة تطبيقات الشريك” أو “الخدمة”) على الطبقات التي يُذكر فيها تطبيق SLA. تُدمج هذه الاتفاقية في وتحكمها الاتفاقية بينك وبين Wink التي من خلالها تصل إلى واجهة برمجة تطبيقات الشريك (“الاتفاقية”)، وتطبق طالما تحافظ على اشتراك نشط ومدفوع في واجهة برمجة تطبيقات الشريك بحالة جيدة. المصطلحات المكتوبة بحروف كبيرة وغير المعرفة هنا لها المعنى المعطى لها في الاتفاقية.

1. التعريفات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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