الاتصال بواجهة برمجة تطبيقات Cato من GraphQL Playground

تشرح هذه المقالة كيفية استخدام GraphQL Playground لتشغيل بعض استعلامات العينات واختبار الاتصال بنقطة نهاية واجهة برمجة تطبيقات Cato Networks.

نظرة عامة على GraphQL Playground

يتيح لك GraphQL Playground تشغيل استعلامات واجهة برمجة التطبيقات التي تُرسل مباشرة إلى خادم واجهة برمجة تطبيقات Cato. برنامج استعلام واجهة برمجة التطبيقات الخارجي مثل Altair أو Postman، يوفر وظائف قوية لتشغيل استدعاءات واجهة برمجة التطبيقات. ومع ذلك، إذا كانت هناك مشكلة في الاتصال باستعلامات واجهة برمجة التطبيقات، يمكنك استخدام الملعب للمساعدة في تحديد سبب المشكلة.

المتطلبات

لتشغيل استعلام واجهة برمجة تطبيقات Cato من GraphQL Playground، يجب أن تمتلك مفتاح واجهة برمجة التطبيقات لحسابك (الموارد > مفاتيح واجهة برمجة التطبيقات). لمزيد من المعلومات حول مفاتيح واجهة برمجة التطبيقات، راجع توليد مفاتيح واجهة برمجة التطبيقات لواجهة Cato.

تحتاج إلى إدخال معرف تطبيق إدارة Cato (CMA) لحسابك في استعلامات العينات. يمكنك العثور على معرف CMA في صفحة معلومات الحساب.

عنوان URL لنقطة نهاية واجهة برمجة التطبيقات خاص بالموقع الذي يتم فيه استضافة مثيل تطبيق إدارة Cato (CMA). قد يكون هناك قيمة <بادئة> تضاف إلى عنوان URL لحساب CMA الخاص بك وإلى نقطة نهاية واجهة برمجة التطبيقات.

  • إذا لم تكن هناك بادئة (مثل cc.catonetworks.com)، فاستخدم عنوان URL التالي: https://api.catonetworks.com/api/v1/graphql2

  • إذا كانت هناك بادئة (مثل cc.us1.catonetworks.com)، فستستخدم عنوان URL التالي: https://api.us1.catonetworks.com/api/v1/graphql2

اختبار الاتصال باستعلامات واجهة برمجة تطبيقات Cato النموذجية

يمكنك تشغيل استعلام واجهة برمجة تطبيقات نموذجي لاختبار الاتصال بخادم واجهة برمجة تطبيقات Cato. عندما يتم تكوين الوسيط accountID ومفتاح واجهة برمجة التطبيقات بشكل صحيح، يُعيد الاستعلام النموذجي لواجهة برمجة التطبيقات بيانات الحساب ويظهر النتائج في GraphQL Playground. إذا لم يقم الاستعلام بإرجاع النتائج لحسابك، فقد تكون هناك مشكلة في الاتصال بخادم واجهة برمجة التطبيقات أو قد يكون الخادم معطلاً. يمكن لاستعلامات واجهة برمجة التطبيقات النموذجية التالية مساعدتك في اختبار الاتصال بخادم واجهة برمجة تطبيقات Cato:

تشغيل استعلام واجهة برمجة التطبيقات النموذجي في GraphQL Playground

استخدم متصفح الإنترنت لفتح GraphQL Playground لواجهة برمجة تطبيقات Cato. قم بتكوين رأس HTTP للملعب باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك. قم بلصق الاستعلام النموذجي في جزء اليسار وأدخل معرف حسابك. ثم يمكنك تشغيل الاستعلام ورؤية النتائج في الملعب.

  1. قم بتنزيل أحد استعلامات واجهة برمجة التطبيقات النموذجية من هذه المقالة وافتح الملف في محرر نصوص مثل Notepad.

  2. من متصفح الإنترنت، قم بالذهاب إلى GraphQL Playground لواجهة برمجة تطبيقات Cato.

  3. في الجزء السفلي من جزء اليسار، انقر HTTP HEADERS.

  4. أدخل مفتاح واجهة برمجة التطبيقات الخاص بك بهذا التنسيق: { "x-api-key" :"<api key>" }.

    تُظهر لقطة الشاشة التالية رأس HTTP المُكَوَّن بمفتاح واجهة برمجة التطبيقاتAaBbCcDdEeFf0123456789ABCDEF1234:

    graphql1.png
  5. انسخ وألصق أحد الاستعلامات النموذجية في جزء اليسار من الملعب.

  6. في الجزء العلوي من الاستعلام، أدخل معرف الحساب الخاص بك في وسيط accountID.

    تُظهر لقطة الشاشة التالية وسيط accountID مُكَوَّن بالقيمة 2626:

    graphql2.png
  7. انقر فوق زر التشغيل.

  8. يعرض الجزء الأيمن نتائج استعلام واجهة برمجة التطبيقات. تُظهر لقطة الشاشة التالية النتائج لاستعلام accountMetrics النموذجي لمعرف الحساب 2626:

    graphql3.png

هل كان هذا المقال مفيداً؟

1 من 1 وجدوا هذا مفيداً

لا توجد تعليقات