جرّب نقطة نهاية في بيئة التجربة

قبل أن تبدأ#

• تستطيع فتح بيئة التجربة وقراءة نقاط النهاية والمعاملات والأمثلة ومقتطفات الشيفرة دون حساب. ولإرسال طلب يجب أن تكون مسجّل الدخول ومشتركاً في المنتج، وأن يكون المنتج مضافاً إلى تطبيق من البيئة التي تختبرها (من التسجيل إلى أول استدعاء).
• اعرف البيئة التي تريدها: ترسل بيئة التجربة الطلب إلى عنوان بوابة البيئة التي تختارها، بمفتاح تطبيق من تلك البيئة (Sandbox وبيئة الإنتاج).

الخطوات#

1. افتح المنتج في السوق واضغط انتقل إلى بيئة التجربة. والزر المجاور لنقطة نهاية في علامة تبويب نقاط النهاية يفتح بيئة التجربة على نقطة النهاية تلك.
2. في الأعلى اختر البيئة والنسخة. لا يسرد المبدّل غير البيئات التي يقدّمها المنتج.
3. في القائمة التي على الجانب اختر نقطة نهاية. يعرض الشريط العلوي الطريقة ورابط الطلب.
4. افتح علامة تبويب التطبيق. اختر التطبيق في التطبيق: لا تضم القائمة غير تطبيقاتك التي أُضيف إليها المنتج من هذه البيئة. واختر مفتاحه في الصلاحيات فيمتلئ الحقل الذي تحته بالمفتاح. وما يحويه الحقل هو بالضبط ما يُرسَل، فيمكنك أيضاً أن تكتب فيه مفتاحاً.
5. افتح المحددات واملأ معاملات المسار، وهي مطلوبة، ومعاملات الاستعلام. وتضم الرأس الترويسات التي عرّفها المزوّد لنقطة النهاية، والجسم محرّر JSON بمثال المزوّد. ويُعطَّل الجسم في GET وHEAD وDELETE وOPTIONS.
6. اضغط ابدأ الاختبار. يظهر الزر حين تكون مسجّل الدخول ويكون تطبيق من البيئة مشتركاً في المنتج.
7. اقرأ الجواب تحت النتائج: الحالة والزمن والحجم والمحتوى، مع نسخ الرد. وترويسات الاستجابة تعرض الترويسات التي يسمح المتصفح للصفحة بقراءتها.

وتحت مقتطفات من الكود يُكتب الطلب نفسه بـ cURL وNode.js وPHP وGo. وفي بيئة التجربة يحمل المقتطف المفتاح الذي اخترته، فلا تلصقه في مكان عام. وSwagger JSON وPostman Collection تحت النتائج تنزّلان تعريف المنتج.

يغادر الطلب متصفحك إلى البوابة مباشرة: ليست المنصة بينهما، ولا يُعاد الاستدعاء الفاشل.

تحقق من النتيجة#

تعرض النتائج الحالة 200 وردّ المنتج. وأمر cURL في المقتطف للطلب نفسه يعطي الجواب نفسه.

إذا حدث خطأ#

• حجب المتصفح الطلب قبل قراءة أي استجابة. يرفض المتصفح تسليم الجواب إلى الصفحة حين لا تسمح البوابة بالاستدعاءات القادمة من عنوان المنصة. هذا ما تفعله بيئة التطوير الخاصة بالمنصة اليوم. انسخ مقتطف cURL وأرسل الطلب من سطر الأوامر: المقتطف هو الطلب نفسه.
• أنت غير مشترك في هذا المنتج. تعرض علامة تبويب التطبيق هذه الرسالة حين لا يحوي أيٌّ من تطبيقاتك المنتج. اشترك، ثم أضف المنتج إلى تطبيق (اشترك بتطبيقك في منتج).
• يرجى اختيار تفويض (مفتاح API) قبل الاختبار. اختر مفتاحاً في الصلاحيات.
• 403 مع No active subscription for this product. لم تطابق البوابة المفتاح مع اشتراك: راجع الأخطاء وإعادة المحاولة.
• ترويسة توقعتها غير موجودة في ترويسات الاستجابة. لا يعرض المتصفح غير ترويسات قليلة ما لم تسمّ البوابة غيرها لتقرأها الصفحة. استخدم cURL مع -i لترى كلها.
• إعدادات الاستدعاء واستدعاء محاكاة وسجلات اختبار الاستدعاء معطّلة. نقطة النهاية لا ترسل استدعاءات راجعة، أو أنك لست مسجّل الدخول (الأحداث والإشعارات).