Setup
يوضح لك هذا المقال كيفية الإعداد بسرعة كمطور والبدء في اختبار واجهات برمجة التطبيقات الخاصة بنا على Wink.
:::ملاحظة يجب إجراء الاختبار دائمًا فيبيئة التجهيزيوجد قدر أقل بكثير من البيانات هناك، ولكنك حر في اختبار ما تريد دون فرض ذلك على بيئة الإنتاج.
بمجرد أن تصبح جاهزًا للبدء، سنقوم بتصديق حسابك وتطبيقك، ويمكنك إطلاقه في بيئة الإنتاج الخاصة بنا.
اتبع الخطوات التالية:
- يسجل حساب المستخدم الخاص بك على Wink
- إنشاء حساب وكيل السفر أو حساب تابع.
- إنشاء تطبيق حيث يمكنك ربطه بالحساب الذي قمت بإنشائه في الخطوة 2.
- بمجرد إنشاء ملفك الشخصي
Application
قم بحفظ معرف العميل وسر العميل في مكان آمن.
شبكة توصيل المحتوى
Section titled “شبكة توصيل المحتوى”في Wink، نستخدم Cloudinary لجميع صورنا ومقاطع الفيديو لدينا. عند وصولك إلى مخزون السفر لدينا، ستتمكن من الوصول الكامل إلى جميع ميزات Cloudinary المتقدمة.
ملكنا cloud_name
يكون traveliko
.
كلاوديناري
Section titled “كلاوديناري”بالنسبة لكل نوع من أنواع مخزون السفر الذي ندعمه، سيكون هناك مجموعة JSON متداخلة تسمىmultimedias
يبدو ملف JSON الخاص بإدخال الوسائط المتعددة على النحو التالي:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
يُظهر الخط المميز أعلاه معرف Cloudinary الفريدpartners/radisson_blu_logo
هذا كل ما تحتاجه لاسترجاع الصورة بأي تنسيق وبأي جودة وبأي حجم تريده.
الاختبار
Section titled “الاختبار”توجه إلى موقعناواجهات برمجة التطبيقاتالقسم واختر واجهة برمجة التطبيقات التي تريد العمل بها.
وثائق واجهة برمجة التطبيقات
Section titled “وثائق واجهة برمجة التطبيقات”تم إعداد موقع التوثيق الخاص بنا بطريقة تمكنك من تشغيل أوامر API من داخل الموقع.
في هذا المثال، تريد استخدامSearch Lookups (OAuth2)
استدعاء API.
:::نصيحة احترافية]
لتسهيل الاستخدام، نوصي المُدمجين باستخدام نقاط النهاية التي نُحددهاOAuth2
تعرف نقاط النهاية هذه أنها تتوقع مكالمات واجهة برمجة التطبيقات وتعرف بالفعل الحساب الذي تستخدمه حتى لا تضطر إلى تحديدcompanyIdentifier
في عناوين URL الخاصة بك.
- استخدم واجهة برمجة التطبيقات للبحث لاسترجاع الوجهات أو الفنادق.
- في شريط التنقل الأيسر، انقر فوق
Authentication
. - أدخل معرف العميل وسر العميل وانقر على
Get TOKEN
زر. - إذا كانت بيانات الاعتماد الخاصة بك صالحة، فستجد أن مفتاح API الخاص بك قد تم تطبيقه.
- يمكنك الآن اختبار نقطة نهاية البحث.
ساعي البريد
Section titled “ساعي البريد”يمكنك القيام بنفس الشيء مع Postman.
- تحميل ساعي البريد.
- انقر على
Download OpenAPI spec
من أعلى واجهة برمجة التطبيقات للبحث صفحة. - استيراده إلى Postman.
- إذا قمت باستيراده كمجموعة جديدة تسمى
Wink API
انقر فوق النقاط الثلاث الأفقية الموجودة بجوار اسم المجموعة ثم انقر فوقEdit
. - في
Authorization tab
، اضبطAuth type
إلى OAuth2. - تعيين المجال
Add auth data to
لRequest headers
. - تعيين المجال
Header prefix
لBearer
. - تعيين المجال
Token Name
إلى أي اسم تريد استخدامه للرمز المحفوظ في Postman. على سبيل المثال، Wink Staging. - تعيين المجال
Grant type
لClient Credentials
. - تعيين المجال
Access token URL
إلى https://staging-iam.wink.travel/oauth2/token. - تعيين المجال
Client ID
إلى معرف العميل الذي ساعد تطبيقك في إنشائه. - تعيين المجال
Client Secret
إلى سر العميل الذي ساعد تطبيقك في إنشائه. - تعيين المجال
Scope
لinventory.read inventory.write inventory.remove
هذه هي كل النطاقات التي ستحتاجها لـ Wink. - تعيين المجال
Client Authentication
لSend as Basic Auth header
. - انقر على
Get New Access Token
زر لاسترداد الرمز الخاص بك وحفظه. - بالنسبة لجميع مكالمات واجهة برمجة التطبيقات ضمن مجموعة Wink API، تأكد من أن علامة التبويب المصادقة تقول
Inherit auth from parent
لذا فهو يتضمن الرمز الخاص بك مع كل مكالمة.
نصيحة احترافية: يُنصح بتحويل نطاق الخادم، ومعرف العميل، وسر العميل إلى متغيرات بيئة. بهذه الطريقة، يمكنك التبديل بسهولة بين بيئتي التشغيل والإنتاج، وإعادة استخدام جميع العمليات التي أنشأتها. :::