اختبار واجهات Api المخصصة

في Oracle Mobile Hub، يمكنك اختبار واجهات API المخصصة قبل توزيعها باستخدام بيانات mock. يمكنك أيضًا اختبار موصلات REST باستخدام صفحة الاختبار التي تدعم وضعين: الاختبار القياسي والاختبار المتقدم.

اختبار API مخصص للوحة وصل Oracle للأجهزة المتنقلة

لاختبار واجهة برمجة التطبيقات المخصصة مباشرة من Oracle Mobile Hub:

تسجيل الدخول إلى Oracle Mobile Hub.
انقر على أيقونة القائمة، ثم قم بتوسيع التطوير وانقر على للخلف.
حدد خلفية النقال وانقر على فتح.
انقر على إعدادات في شريط الاستكشاف الأيسر.
قم بنسخ عنوان URL من نقطة انتهاء مقطع SSO الموجودة أسفل عناوين URL للبيئة.
قم بلصق عنوان URL المنسوخ في نافذة متصفح ويب، دون الضغط على مفتاح Enter.
انسخ معرف العميل الموجود أسفل قسم مستهلك OAuth.
أضف معلمة سلسلة استعلام إلى عنوان URL لنقطة انتهاء مقطع SSO الذي قمت بلصقه في متصفح الويب في النموذج?clientID=[YourClientID]، ثم اضغط على المفتاح Enter. مثال على عنوان URL يشبه ذلك:
```
https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>
```
يعرض المتصفح مقطع OAuth للدخول الموحد.
في النافذة الخلفية للأجهزة المتنقلة، انقر صفحة واجهات برمجة التطبيقات الموجودة في التنقل الأيسر. سوف يتغير المستعرض من صفحة الإعدادات إلى صفحة APIs
انقر على تحديد واجهات Api.
انقر اسم API الذي تريد اختباره يتم فتح صفحة جديدة تعرض نقاط انتهاء API في التنقل الأيسر بالإضافة إلى علامات تبويب الطلب والاستجابة.
انقر على نقطة الانتهاء التي تريد اختبارها.
أسفل قسم التصديق، حدد مقطع الدخول الموحد من أسلوب التصديق.
انسخ مقطع الدخول الموحد OAuth والصقه في حقل مقطع الدخول الموحد.
انقر على نقطة انتهاء الاختبار. إذا كان كل شيء صحيحًا، يستجيب الخادم بالحالة 200، ويجب أن ترى بيانات JSON في الاستجابة.

اختبار نقاط انتهاء API باستخدام بيانات السفر

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

في مثال FixItFast، تتيح لك بيانات mock في نص الاستجابة التحقق من إرجاع معلومات العميل الصحيحة. فيما يلي مثال لبيانات mock الذي يمكن لمطور الخدمة تكوينه لنص استجابة عملية POST في مورد contact في مثال FixItFast.

{
 "id": 20934,
 "title": "Lynn's Leaking Water Heater",
       "contact": {
       "name": "Lynn Adams",
       "street": "45 O'Connor Street",
       "city": "Ottawa",
       "postalcode": "ala1a1"
       "username":"johneta"
       }
 "status": "new",
 "driveTime": 30,
 "priority": "high",
 "createdon": "2015-04-23 18:12:03 EDT"
}

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

وحتى تقوم بتكوين التنفيذ الأول، يكون التنفيذ الافتراضي هو التنفيذ mock implementation. بعد تكوين عملية تنفيذ حقيقية، تصبح عملية التنفيذ الافتراضية لواجهة API.

انقر على ارتباط التنقل "عمليات التنفيذ" لتحميل عملية تنفيذ أو لعرض أية عمليات تنفيذ موجودة. يمكن تغيير التنفيذ الافتراضي في صفحة "عمليات التنفيذ". بعد تحميل عملية تنفيذ، سترى قائمة بعمليات التنفيذ الموجودة، والتي تتضمن تنفيذ العملية.

اختبار واجهة برمجة تطبيقات REST Connector

الآن بعد قيامك بتعريف واجهة برمجة تطبيقات REST Connector وحفظ التكوين، ستحتاج للتحقق من إمكانية إرسال طلب واستلام النتائج المتوقعة من خدمة الويب. يعد اختبار الاتصال خطوة اختيارية، لكن يمكنك حفظ الوقت من خلال تحديد المشكلات وإصلاحها الآن قبل إنهاء واجهة API للموصل. تتيح لك صفحة الاختبار اختبار نقطة انتهاء واحدة في كل مرة.

إذا قمت بتوفير واصف، فإن لديك وضعي اختبار للاختيار من بين:

اختبار قياسي

في حالة تقديم بيانات تعريف للخاصية، يتم عرض وضع الاختبار القياسي حيث يتم إنشاء نصوص الطلب والاستجابة من بيانات التعريف الوصفية ويتم عرضها في علامتي تبويب الطلب والاستجابة. كل ما يلزم القيام به هو تحديد المعلمات التي تريد اختبارها باستخدام أساليب GET وتضمين أية رؤوس HTTP تريد اختبارها معها.
اختبار متقدم

يمكنك تنقيح الاختبار بتحديد اختبار في الطور المتقدم (طور الاختبار الذي تدخله في حالة تقديم URL خدمة بعيدة) فبدون ميتاديتا وصفية، يلزم تحديد الأسلوب والمورد لاختبارهما، قم بتضمين أي رؤوس HTTP تريد تضمينها، وقم بتكوين نص JSON يدويًا.

الاختبار في الوضع المتقدم

تتيح لك صفحة الاختبار المتقدم تعيين معلمات المسار وإضافة الرؤوس وتحميل البيانات الخاصة بالطلب والاستجابة يدويًا.

لتكوين اختبار موصل يدويًا:

انقر على ارتباط التنقل "اختبار".
إذا قمت بتوفير واصف، فقم بإجراء الاختبار في الوضع المتقدم إلى On.

يتم عرض صفحة الاختبار المتقدم تلقائيًا إذا قمت بتوفير عنوان url لخدمة بعيدة.
حدد أسلوب HTTP الذي تريد اختباره من القائمة المنسدلة.
حدد أية معلمات مسار مورد في حقل معرف URI المحلي حسب الحاجة لأغراض الاختبار. على سبيل المثال:
```
directions/json?origin=los+angeles&destination=seattle
```
يبدأ الحقل تلقائيًا بمعرف URI المحلي الذي قمت بتعريفه عند إدخال اسم API. يتبع المثال الخاص بنا، سيبدو المحتوى الكامل للحقل كما يلي:
```
myMapAPI /directions/json?origin=los+angeles&destination=seattle
```
لاحظ أنه في حالة تعريف أية قواعد، يعرض حقل "القواعد المطبقة" (أسفل حقل النص) الأرقام التي تتطابق مع القواعد القابلة للتطبيق للعملية المحددة. يعرض حقل "URL البعيد" السلسلة المطابقة التي سيتم تمريرها إلى خدمة الاختبار.
أضف رأس HTTP لطلب أو استجابة أو أكثر حسب الحاجة.

هذه الرؤوس لأغراض الاختبار فقط ولن تتم إضافتها إلى تكوين واجهة برمجة تطبيقات REST Connector.
انقر في حقل نص HTTP لتكوين نص الرسالة (الحمولة) في محرر المصدر.
على سبيل المثال:
```
{
  "status":"ZERO_RESULTS",
  "routes":[ ]
}
```
احتفظ بمحتوى نص الرسالة ذي الصلة بغرض الموصل، أي لا تدخل الرسالة عن طريق إضافة بيانات خارجية. إن تضمين البيانات ذات الصلة فقط في نص الرسالة يسهل الإرسال السريع للطلب أو الاستجابة.
إذا كانت الخدمة التي تتصل بها تتطلب تصديقًا، افتح قسم "التصديق" وأدخل صلاحيات مستخدم الجوال لكل أسلوب تقوم باختباره. إذا كنت تستخدم صلاحيات اختبار افتراضية، فيمكنك تخطي هذه الخطوة.

باستخدام أنظمة التأمين المستندة إلى SAML، يتم نشر هوية المستخدم الذي يقوم بالاستدعاء في الخدمة الخارجية. بالنسبة لأنظمة التأمين الأخرى مثل مقطع تصديق HTTP الأساسي واسم المستخدم، يتم توفير الصلاحيات المستخدمة للتصديق مع الخدمة الخارجية في تجاوزات النظام كمفاتيح CSF. ووفقًا للعملية التي حددتها، قد يتعين عليك إدخال بيانات صلاحية معينة لكل عملية أو قد تكون قادرًا على استخدام مجموعة واحدة من بيانات الصلاحية لكل الأساليب لتصديق الموصل مع الخدمة.
انقر على حفظ باسم بيانات الصلاحية الافتراضية الحالية للخلفية المتحركة لحفظ اسم المستخدم وكلمة السر اللذان أدخلتهما على أنهما الافتراضية.
إذا كنت في مرحلة التصميم الخاصة بتكوين الموصل وترغب للتو في الاطلاع على ما إذا كانت نقاط الانتهاء صالحة أم لا، فانقر على صلاحيات اختبار مصمم واجهة برمجة التطبيقات الافتراضية وحدد نهاية تطبيقات الأجهزة المتنقلة المسجلة بها ورقم إصدارها.
بشكل اختياري، يمكنك إدخال بيانات صلاحية مستخدم الجوال (اسم المستخدم وكلمة السر).
تكون صلاحيات الاختبار الافتراضية ثابتة على مستوى جميع الأساليب التي تقوم باختبارها. لكنها تظل صالحة أثناء جلسة عمل Mobile cloud الحالية.
انقر على نقطة انتهاء الاختبار.

مفاتيح نقطة انتهاء الاختبار لإلغاء الاختبار عند النقر عليه. إذا كنت تريد إيقاف الاختبار لأي سبب، انقر إلغاء الاختبار.

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