التطبيقات

تمنحك التطبيقات إمكانية الوصول إلى جميع ميزات Wink كمطور. يمكنك الوصول إلى جميع البيانات نفسها وحتى توسيع ميزات Wink الخاصة. يمكنك اختيار استخدام خادم OAuth2 الخاص بـ Wink لتوثيق موقع السفر الخاص بك بنفس الطريقة التي تستخدم بها Google أو Facebook. بهذه الطريقة يمكنك توسيع ميزات Wink إلى موقعك الإلكتروني أو تطبيقك الخاص.

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

إنشاء تطبيق

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

أنواع العملاء

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

تطبيق ويب — تطبيق يتم تقديمه من الخادم يمكنه الاحتفاظ بمفتاح سري للعميل بأمان (تدفق رمز التفويض).
تطبيق صفحة واحدة (SPA) — تطبيق متصفح بدون خلفية؛ يستخدم PKCE، بدون مفتاح سري للعميل.
تطبيق جوال — تطبيق iOS/Android أصلي؛ يستخدم PKCE مع تدوير رموز التحديث.
آلة إلى آلة — خدمة خلفية تعمل ككيان مستقل (بيانات اعتماد العميل)؛ بدون تسجيل دخول المستخدم.

فيما يلي خطوات إنشاء تطبيق:

من صفحة التطبيقات، انقر على زر إنشاء تطبيق جديد.
الاسم امنح تطبيقك اسمًا. مثال: تطبيق رائع
نوع العميل اختر النوع الذي يتطابق مع طريقة توثيق تطبيقك — انظر أنواع العملاء أعلاه.
عناوين URI لإعادة التوجيه مطلوب عنوان URI واحد على الأقل لإعادة التوجيه. يُستخدم للتحقق من صحة نطاق إعادة التوجيه بعد توثيق ناجح. لا يُستخدم لتطبيقات آلة إلى آلة. مثال: https://www.cool-site.com
عناوين URI لإعادة التوجيه بعد تسجيل الخروج (اختياري) عناوين URL التي يمكن إعادة توجيه المستخدمين إليها بعد تسجيل الخروج. اتركها فارغة لإعادة استخدام عناوين URI لإعادة التوجيه أعلاه.
النطاقات اختر ما يمكن لهذا التطبيق الوصول إليه نيابة عنك — انظر اختيار النطاقات أدناه.
انقر على زر إنشاء التطبيق للمتابعة.

سيتم إعادة توجيهك إلى قائمة تطبيقاتك، وسيظهر مربع حوار لمرة واحدة يعرض معرف العميل الجديد والمفتاح السري للعميل. انسخ المفتاح السري الآن واحتفظ به في مكان آمن — لن يُعرض مرة أخرى، ولا توجد طريقة لاسترجاعه لاحقًا (يمكنك فقط تدويره للحصول على مفتاح جديد).

اختيار النطاقات

يحمل كل تطبيق دائمًا نطاقات تسجيل الدخول (OpenID Connect) (openid، profile، email، offline_access) — هذه تؤكد هوية المستخدم وتحافظ على تسجيل دخوله، لذا فهي محددة ومقفلة؛ وليست اختيارًا.

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

هناك عائلتان من النطاقات غير معروضة عمدًا في هذا النموذج:

mcp.* — وصول وكيل الذكاء الاصطناعي إلى بروتوكول نقل Model Context Protocol، الذي يتم توفيره بشكل منفصل وفقط لعملاء آلة إلى آلة.
نطاقات مستوى المسؤول (administrator.*) — وصول على مستوى المنصة لا يُمنح لكل تطبيق.

بمجرد إنشاء التطبيق، يعرض هذا التبويب والتطبيقات المصرح بها نطاقاته الممنوحة مجمعة حسب القسم (مثل “الحجوزات: booking.read”)، حتى تتمكن من رؤية ما يمكن للتطبيق القيام به بنظرة سريعة دون فتحه.

تدوير بيانات الاعتماد

إذا كان من المحتمل أن يكون المفتاح السري قد تسرب، أو إذا أردت فقط بيانات اعتماد جديدة، قم بتدويرها بدلاً من إعادة إنشاء التطبيق:

ابحث عن التطبيق في قائمة تطبيقاتك وانقر على تدوير.
أكد مربع الحوار — يتوقف معرف العميل والمفتاح السري الحاليان عن العمل فورًا.
انسخ معرف العميل والمفتاح السري الجديدين من مربع الحوار لمرة واحدة قبل إغلاقه.

التدوير يحافظ على اسم التطبيق، نوع العميل، عناوين URI لإعادة التوجيه، والنطاقات — فقط بيانات الاعتماد تتغير.

إزالة التطبيق

إذا لم تعد بحاجة إلى تطبيق، يمكنك حذفه. هذا إجراء دائم — تُلغى بيانات الاعتماد على الفور ولا يمكن استعادتها.

ابحث عن التطبيق في قائمة تطبيقاتك وانقر على حذف.
أكد مربع الحوار لحذف التطبيق نهائيًا.