التطبيقات

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

ملاحظة

تم إنشاء تطبيقك الأول بالفعل عند إنشاء حساب جديد. نستخدم هذا التطبيق في بعض سيناريوهات الحجز.

لا يمكنك إعادة استخدام هذا التطبيق. يرجى إنشاء تطبيقات جديدة حسب حاجتك.

مثال على إدخال تطبيق

ملاحظة

يمكن استخدام التطبيق الذي تم إنشاؤه على Wink لجميع نقاط نهاية API.

1. اختر الحساب الذي تريد العمل معه من Accounts.
2. انقر على Actions من أسفل بطاقة الحساب واختر Manage account.
3. انقر على تبويب Applications في الصفحة التالية.
4. ستعرض هذه القسم جميع تطبيقاتك.
5. اختر تعديل تطبيق موجود أو إنشاء تطبيق جديد.

إنشاء تطبيق

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

تنبيه

تحتاج إلى إنشاء حساب تابع على Wink أو حساب على TripPay قبل إنشاء تطبيق لأنك سترتبط تطبيقك بحساب معين.

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

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

• SPA (تطبيق صفحة واحدة) — لتطبيقات الواجهة الأمامية التي تعمل في المتصفح وتستخدم تدفق رمز التفويض OAuth2 مع PKCE. هذا هو النوع الأكثر شيوعًا لتطبيقات الويب.
• MACHINE_2_MACHINE — للتكاملات من خادم إلى خادم التي تقوم بالمصادقة مباشرة باستخدام بيانات اعتماد العميل. استخدم هذا عندما يحتاج خادمك الخلفي إلى استدعاء Wink APIs بدون وجود مستخدم.

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

1. من صفحة التطبيقات، انقر على زر Create new application.
2. الاسم امنح تطبيقك اسمًا. مثال: تطبيق رائع
3. نوع العميل اختر SPA لتطبيقات الويب أو MACHINE_2_MACHINE للتكاملات الخدمية.
4. اسم الكيان اربط تطبيقك بأحد حساباتك الموجودة. مثال: حساب رائع
5. عناوين URI لإعادة التوجيه مطلوب عنوان URI واحد على الأقل لإعادة التوجيه. يُستخدم للتحقق من صحة نطاق إعادة التوجيه بعد المصادقة الناجحة. مثال: https://www.cool-site.com
6. عناوين URI لإعادة التوجيه بعد تسجيل الخروج (اختياري) عناوين URL التي يمكن إعادة توجيه المستخدمين إليها بعد تسجيل الخروج. هذا يضمن وصول المستخدمين إلى صفحة معروفة بعد انتهاء جلستهم.
7. انقر على زر Save للمتابعة.

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

تحديث التطبيق

ستحتاج إلى تحديث تطبيقك إذا تغير أحد عناوين URI لإعادة التوجيه أو أردت إضافة أو إزالة URI.

لتحديث تطبيق موجود، قم بما يلي:

1. انقر على رابط Actions للتطبيق الذي تريد تحديثه.
2. انقر على زر Update تحت Actions.
3. قم بإجراء التغييرات على التطبيق.
4. انقر على زر Save للمتابعة.

سيتم إعادة توجيهك إلى قائمة تطبيقاتك.

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

تنبيه

يرجى عدم حذف التطبيق الذي أنشأناه تلقائيًا لك لضمان عمل جميع الميزات لحسابك.

إذا لم تعد بحاجة إلى تطبيق، يمكنك المتابعة وحذفه.

لحذف تطبيق، قم بما يلي:

1. انقر على رابط Actions للتطبيق الذي تريد تحديثه.
2. انقر على زر Remove تحت Actions.
3. انقر على زر OK لتأكيد الحذف.

سيتم إعادة توجيهك إلى قائمة تطبيقاتك.