تخطَّ إلى المحتوى
للمطورين

ابنِ تجارة الفنادق داخل منتجك.

Section titled “ابنِ تجارة الفنادق داخل منتجك.”

تجارة الفنادق التي تبدأ بـ API: البحث، الحجز، الدفع، 70 ويب هوكس، التتبع وتسليم الذكاء الاصطناعي — مع خادم MCP مستضاف لقراءة العقود الحية، وBooking Engine للتنفيذ في الخلفية.

REST + OAuth2 + SDKs خادم MCP مستضاف 70 أحداث ويب هوك
wink · agent integration live

# 1 · connect an agent or coding client

$ claude mcp add wink

https://api.wink.travel/mcp --transport http

→ browser sign-in at iam.wink.travel

✓ connected · OAuth2 + PKCE · no client secret

# 2 · find the operation, read the live contract

api_search "create booking"

→ POST /bookings · wink://api/operation/createBooking

# 3 · create the booking, take payment

$ wink bookings create --rate rp_8421

201 · #WK-2X9F · paid via Wink

# 4 · react in real time

on booking.create → fulfill & reconcile

ماذا يمكن للمطورين بناءه مع Wink؟

يمكن للمطورين بناء تدفقات بحث الفنادق، الحجز، الدفع، الويب هوكس، التتبع، التقارير، تسليم الذكاء الاصطناعي والتجارة المدمجة داخل منتجاتهم الخاصة. يعمل وصول مطوري Wink مع عروض الفنادق التي يتحكم بها Extranet، وسياق الشركاء من الشبكة الأساسية، وتسليم الذكاء الاصطناعي عبر Agentic AI، وتنفيذ Booking Engine لعمليات الدفع، التأكيد، وإكمال الحجز الخاصة بالفنادق.

لمن هذا موجه

للفِرَق التي تبني تجارة الفنادق، وليس فقط لقراءة الوثائق.

Section titled “للفِرَق التي تبني تجارة الفنادق، وليس فقط لقراءة الوثائق.”

يُناسب وصول المطور فرق المنتج، الهندسة، الذكاء الاصطناعي، المنصة والعمليات. هل تقيم تكاملًا لمنتج ذكاء اصطناعي، بنك أو تطبيق شامل؟ انظر للفِرَق والمنصات والذكاء الاصطناعي.

فرق المنتج

أضف تجارة الفنادق إلى تطبيق أو منصة موجودة عبر وصول المطور + Booking Engine.

فرق منتجات الذكاء الاصطناعي

وجّه نية الحجز التي يقودها المساعد إلى تدفقات حجز محكومة مع Agentic AI وخادم MCP.

الوكالات وDMCs

ابنِ واجهات مخصصة، تدفقات حجز أو منتجات خط سير الرحلة باستخدام مكونات الويب.

مدير القناة / PMS

نسق التوافر، الأسعار، الحجوزات وتدفقات الأحداث ذات الصلة.

لماذا تبني عليه

بطاقة الفندق سهلة. نظام حجز الفنادق ليس كذلك.

Section titled “بطاقة الفندق سهلة. نظام حجز الفنادق ليس كذلك.”

تجارة الفنادق تحتاج إلى قواعد العرض، التوافر، الأسعار، العروض، السياسات، الدفع، التأكيد، التتبع والتقارير. ابنِ على هذه الطبقات بدلاً من إعادة بنائها.

  • إعادة بناء قواعد العرض، السعر والسياسة
  • ربط الدفع ببيانات الفندق المحددة
  • ربط التتبع عبر الجلسات
  • امتلاك عمليات الدفع، الاسترداد والمصالحة
  • حماية الذكاء الاصطناعي حتى لا يخترع التوافر
  • صيانتها جميعًا مع تغير الفنادق يوميًا
  • دمج العرض المعتمد من الفندق عبر Extranet
  • Booking Engine يتولى الدفع، التأكيد وإتمام الحجز
  • الاحتفاظ بالتتبع لمدة 6 أشهر لكل نقرة
  • الاشتراك في 70 أحداث ويب هوك
  • تسليم الذكاء الاصطناعي المنظم عبر MCP + Agentic AI
  • 1.5% + تكلفة المعالجة — Booking Engine تحت كل تسليم

النموذج

من أول اتصال إلى حجز مؤكد.

Section titled “من أول اتصال إلى حجز مؤكد.”

مسار تكامل واحد من الاتصال إلى التنفيذ.

  1. 1

    الاتصال

    أضف خادم MCP المستضاف أو أنشئ بيانات اعتماد OAuth2 للبدء مع العقود الحية.

  2. 2

    قراءة العقود الحية

    ابحث عن العمليات واقرأ مخططات الطلب والاستجابة الحالية — لا تخمين، لا وثائق قديمة.

  3. 3

    بناء التدفق

    اربط البحث، التوافر، الحجز، الدفع والتقارير داخل منتجك.

  4. 4

    الاشتراك في الأحداث

    التفاعل مع 70 أحداث ويب هوك: حالة الحجز، المدفوعات، الاستردادات، الإلغاءات وتغييرات القناة.

  5. 5

    التنفيذ في Booking Engine

    كل مكالمة تُحل في Booking Engine للدفع، التأكيد وإتمام الحجز الخاص بالفندق.

لوكلاء الذكاء الاصطناعي — ابدأ هنا

اتصل، ثم اقرأ العقود الحية.

Section titled “اتصل، ثم اقرأ العقود الحية.”

يتيح خادم MCP المستضاف للوكيل اكتشاف واجهات Wink وبناء تكامل عملي دون تخمين نقاط النهاية.

نقطة نهاية HTTP قابلة للبث (SSE كخيار احتياطي في /sse). من Claude Code:

claude mcp add —transport http 
wink-docs https://docs.mcp.wink.travel/mcp

يعمل أيضًا مع Codex، Cursor وVS Code — انظر وثائق MCP.

أداتان تحللان النية إلى عمليات فعلية ووثائق مفاهيمية:

  • api_searchابحث عن العملية التي تريد استدعائها — مثل “البحث في المخزون”، “إنشاء حجز”، “إيصال الدفع”
  • docs_searchابحث عن المفاهيم — “المصادقة”، “الويب هوكس”، “التتبع”

كل نتيجة تعيد URI wink:// — افتح العملية، مخطط الطلب/الاستجابة، أو وصفة المهمة.

3 · ابنِ باستخدام مهارة الذكاء الاصطناعي

Section titled “3 · ابنِ باستخدام مهارة الذكاء الاصطناعي”

wink-api-builder يستخدم خادم MCP كمصدر للحقيقة: api_search → العقود الحية → المصادقة → كود موثوق، وينبه لأي اختلاف مع API الحالي.

يعمل مع Claude Code، Codex وCursor — انظر مهارات الذكاء الاصطناعي.

أنشئ الحجز عبر API وBooking Engine ينفذه — الدفع، التأكيد ومزامنة الحجز مع PMS أو مدير القناة المتصل، مع الحفاظ على سياق المصدر.

اشترك في booking.create و63 حدثًا آخر للتفاعل في الوقت الحقيقي.

محرك واحد، كل التكاملات

كل التكاملات تلتقي في Booking Engine.

Section titled “كل التكاملات تلتقي في Booking Engine.”

بغض النظر عن كيفية إرسال منتجك للطلب — API، وكيل، مكون أو رابط — يتم حل الحجز في مكان واحد تتحكم به.

  • REST API
  • MCP / agents
  • Web Components
  • WinkLinks
  • Studio + network
  • Partner apps

Booking Engine

checkout · payment · confirmation

حجز مؤكد

تم أخذ الدفع، تم تأكيد الضيف، وتم الحفاظ على التتبع وسياق المصدر.

النطاق الكامل

من بناء API كامل إلى مكون قابل للإدراج.

Section titled “من بناء API كامل إلى مكون قابل للإدراج.”

تعمق كما في تكامل REST + MCP كامل — أو، عندما يكون ذلك أكثر مما يحتاجه العمل، أدرج مكون ويب من Studio: بطاقات الفنادق، الخرائط، الشبكات ووحدات الحجز. في كلتا الحالتين، ينفذ Booking Engine الحجز في الخلفية.

  • API كامل REST + OAuth2، خادم MCP مستضاف وعملاء مولدون
  • أو مكونات ويب قابلة للحجز — بطاقات، خرائط وشبكات
  • 70 أحداث ويب هوك للمصالحة في الوقت الحقيقي
  • تنفيذ Booking Engine تحت كل واجهة
شاهد وثائق Build on Wink
مكون ويب بطاقة فندق قابل للتضمين من Wink

أسئلة شائعة للمطورين

ما تسأله الفرق التقنية ومنتجات أولاً.

هل هناك صفحة منتج منفصلة للوصول إلى API؟
لا. يتم التعامل مع الوصول إلى API من خلال صفحة Builders ووثائق Build on Wink، وليس من خلال صفحة منتج تسويقية مستقلة.
هل يحل الوصول إلى API محل Booking Engine؟
لا. الوصول إلى API يوجه الطلبات ومنطق التكامل. يظل Booking Engine طبقة التنفيذ لعمليات الدفع، التأكيد، وإكمال الحجز الخاصة بالفنادق.
هل يمكن للمساعدين الذكاء الاصطناعي استخدام Wink؟
نعم. يتيح خادم MCP المستضاف لوكلاء الذكاء الاصطناعي قراءة عقود API الحية بحيث يمكنهم البحث في عروض الفنادق الحية، إنشاء الحجوزات، وأخذ الدفع عبر Booking Engine — مما يكمل الحجز في تدفق واحد، وليس فقط توجيه المستخدم إلى موقع ويب. أي فندق جاهز لوكيل بمجرد أن يكون ملفه الشخصي مباشرًا على Wink.
هل يمكنني تضمين بطاقات الفنادق أو الخرائط بدون تكامل API كامل؟
نعم. يمكن لـ Studio إنشاء مكونات ويب مثل بطاقات الفنادق، الخرائط، الشبكات وأصول مدمجة أخرى عندما يكون مسار أقل تعقيدًا كافيًا — ويقوم Booking Engine بتنفيذ الحجز في الخلفية.
هل يمكن لمجموعات الفنادق استخدام وصول المطور؟
نعم. يمكن لمجموعات الفنادق والمشغلين الفنيين استخدام وصول المطور لربط عروض Wink، تدفقات الحجز والتقارير مع الأنظمة الداخلية.
من أين يجب أن يبدأ المطورون؟
اتصل بخادم MCP، اقرأ وثائق Build on Wink، ثم أنشئ بيانات اعتماد OAuth2 وابدأ البناء في بيئة الاختبار — لا حاجة لطلب وصول أو انتظار. عندما تكون جاهزًا، أنشئ تطبيقًا في الإنتاج ووجه الكود إلى عناوين URL الخاصة بالإنتاج.
هل الوصول للمطورين مفتوح للجميع؟
نعم. الوثائق وخادم MCP متاحان للجميع، ويمكن لأي مطور إنشاء بيانات اعتماد OAuth2 والبدء في البناء في بيئة الاختبار دون طلب منا. الانتقال إلى الإنتاج لا يحتاج إلى موافقة أيضًا. فقط مدراء القنوات ووكلاء السفر يخضعون لشهادة.

هل أنت مستعد لبناء تجارة الفنادق داخل منتجك؟

Section titled “هل أنت مستعد لبناء تجارة الفنادق داخل منتجك؟”

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