استخدام واجهة برمجة التطبيقات API Monitoring Management

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

استخدم واجهة برمجة التطبيقات API Monitoring Management API لتنفيذ المهام التالية.

مهمة مزيد من المعلومات
إدارة التنبيهات لمراقبة واجهة برمجة التطبيقات
إدارة المجموعات لمراقبة واجهة برمجة التطبيقات
الاطّلاع على سجلات مراقبة واجهة برمجة التطبيقات على مستويات مختلفة
عرض مقاييس مراقبة واجهة برمجة التطبيقات

حصص طلبات البيانات من واجهة برمجة التطبيقات

تفرض جميع واجهات API Monitoring API حصةً تحدّ من عدد المرات التي يمكنك فيها الاتصال بواجهة برمجة التطبيقات في الدقيقة. على سبيل المثال، تفرض واجهة برمجة التطبيقات إنشاء مجموعات قيودًا على ستّ مكالمات في الدقيقة.

لا تحتوي بعض واجهات برمجة التطبيقات على حدود الحصة نفسها. يمكنك الاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات في كل واجهة برمجة تطبيقات لتحديد الحد الأقصى المسموح به لها.

استخدام ثنيات

تستخدم أمثلة واجهة برمجة التطبيقات في هذا المستند curl لتوضيح كيفية استخدام مراقبة واجهة برمجة التطبيقات باستخدام واجهة برمجة التطبيقات. curl أداة مفتوحة المصدر وسطر أوامر لنقل البيانات باستخدام بنية عنوان URL، وتدعم البروتوكولات الشائعة مثل HTTP وHTTPS. للحصول على معلومات عن تنزيل curl واستخدامه، يمكنك الاطّلاع على https://curl.haxx.se/.

يلخص الجدول التالي خيارات سطر الأوامر curl المستخدمة في الأمثلة.

الخيار الوصف
-d '{}'

--data @filename

تحدِّد نص الطلب، التي تم تمريرها مباشرةً أو من خلال تحديد اسم ملف.
-H

--header

تحدد عنوان الطلب. يجب تمرير المعلومات التالية في عنوان الطلب:
  • رمز OAuth 2.0 المميز لمصادقة المستخدم باستخدام عنوان Authorization، كما هو موضح في الحصول على رمز دخول OAuth 2.0.
  • أنواع المحتوى التي يدعمها البرنامج باستخدام العنوان Accept.
  • نوع المحتوى لنص الطلب الذي يتم إرساله عند إنشاء مورد أو تعديله (POST، PATCH، PUT) باستخدام العنوان Content-Type.
-i عرض المزيد من المعلومات، مثل العناوين، في الاستجابة.
-X تحدّد هذه السمة نوع الطلب (GET وPOST وما إلى ذلك).

الحصول على رمز دخول OAuth 2.0

يتوافق Apigee Edge مع بروتوكول OAuth 2.0 لمصادقة المستخدم. باستخدام بروتوكول OAuth 2.0، يمكنك استبدال بيانات اعتماد Apigee Edge برمز دخول ورمز مميّز لإعادة التحميل يمكنك استخدامه بعد ذلك لإجراء مكالمات آمنة مع واجهة برمجة التطبيقات Apigee Edge. وبعد الحصول على رمز مميز، لن تحتاج إلى تبادل بيانات اعتمادك مرة أخرى حتى تنتهي صلاحية الرمز. يسمح لك الرمز المميز للتحديث بالحفاظ على "جلستك" مع الخادم قيد التشغيل لفترة أطول بدون تقديم بيانات الاعتماد. لمزيد من المعلومات حول رموز الدخول، يُرجى الاطّلاع على استخدام OAuth2 للوصول إلى واجهة برمجة تطبيقات الإدارة.

باستخدام بيانات اعتماد Apigee Edge، يمكنك الحصول على رموز الدخول عبر بروتوكول OAuth 2.0 وإعادة تحميل الرموز المميّزة للوصول إلى موارد Apigee Edge باستخدام الأداة المساعدة get_token من Apigee.

للحصول على رمز دخول OAuth 2.0:

  1. ثبِّت الأداة المساعدة get_token. للحصول على معلومات حول كيفية تثبيت أداة get_token، راجع استخدام get_token.

  2. نفِّذ get_token للحصول على رمز دخول بروتوكول OAuth 2.0.

    في المرة الأولى التي تُدخل فيها الأمر أو إذا انتهت صلاحية الرمز المميّز لإعادة التحميل، يطالبك get_token بإدخال اسم المستخدم وكلمة المرور ورمز المصادقة الثنائية المكوَّن من ستة أرقام. أدخِل كل قيمة عندما يُطلب منك ذلك. إذا لم يتم تمكين المصادقة الثنائية، فما عليك سوى الضغط على Enter عند المطالبة.

  3. انسخ رمز OAuth 2.0 المميز وخزِّنه في متغيّر، مثل ACCESS_TOKEN: 

    export ACCESS_TOKEN=eyJhbGciOiJSUzI1NiJ9.eyJqdGkiOiI2NmQ4MTRiMC01YzZkLTQyZWUtYjlmYi05ZGVhODk5MGRiODIiLCJzdWIiOiJlZjc3YmRhMS05ZWIxLTQyZDgtODg5MC0zODQ3ODg0MzM1OWIiLCJzY29wZSI6WyJzY2ltLmVtYWlscy5yZWFkIiwicGFzc3dvcmQud3JpdGUiLCJhcHByb3ZhbHMubWUiLCJzY2ltLm1lIiwic2NpbS5pZHMucmVhZCIsIm9wZW5pZCIsIm9hdXRoLmFwcHJvdmFscyJdLCJjbGllbnRfaWQiOiJlZGdlY2xpIiwiY2lkIjoiZWRnZWNsaSIsImF6cCI6ImVkZ2VjbGkiLCJncmFudF90eXBlIjoicGFzc3dvcmQiLCJ1c2VyX2lkIjoiZWY3N2JkYTEtOWViMS00MmQ4LTg4OTAtMzg0Nzg4NDMzNTliIiwib3JpZ2luIjoidXNlcmdyaWQiLCJ1c2VyX25hbWUiOiJsbHluY2hAYXBpZ2VlLmNvbSIsImVtYWlsIjoibGx5bmNoQGFwaWdlZS5jb20iLCJyZXZfc2lnIjoiZTViZDc3NjIiLCJpYXQiOjE0NzA3NTMyMDksImV4cCI6MTQ3MDc5NjQwOSwiaXNzIjoiaHR0cHM6Ly9sb2dpbi5lMmUuYXBpZ2VlLm5ldC9vYXV0aC90b2tlbiIsInppZCI6InVhYSIsImF1ZCI6WyJzY2ltIiwicGFzc3dvcmQiLCJvcGVuaWQiLCJlZGdlY2xpIiwiYXBwcm92YWxzIiwic2NpbS5lbWFpbHMiLCJzY2ltLmlkcyIsIm9hdXRoIl19.FF3f1i9eHbBqYjnvBmt9nTtTcyNQBQRDDq2tQ3aRUAzUesLAet7qfBB9QVCvE-zVBn4BiPgRU-iturxPxRMAQ2a34-8oLvgff3x-aALBWkSwbc8PJdWTiPP9VYykoFSJtu9UIN5x0FQEQN_hyurO8D2SrS3uQKNwIyjoJPy4Bps7nb3WqJyKRfXAzf8UptdN7XE0TVqTyBcZGT3OQ2Was0VPfe_dr-wIrywvjNf6FczjdktB1lpKJ2oRXx1n8PuK5FhOQ4wE9VeSsNsMHVcGvJ5W6Tvi61fo2h1w1d4AKvGdERzuVf_XWN00mtcgwsUAuXV0r5H_i3vxcMuUym1XOg

عند استدعاء واجهة برمجة التطبيقات لمراقبة واجهة برمجة التطبيقات، أدخِل رمز دخول OAuth 2.0 في عنوان HTTP باستخدام عنوان التفويض. مثال:


curl -X GET "https://apimonitoring.enterprise.apigee.com/alerts?org=myorg"
   -H "Authorization: Bearer $ACCESS_TOKEN" 
   ...