البحث عن الشركات، والأجهزة، والمخزون، والتنبيهات، ثم تصفح النتائج.
اعثر على ما تحتاجه
ابدأ بـ GET /v1/companies، ثم GET، ثم /v1/companies/{companyId}/sites، ثم GET، ثم /v1/devices?companyId={companyId}.. انسخ المعرّفات من هذه الاستجابات. GET، ثم /v1/devices/{deviceId} تقرأ جهازًا مُدارًا واحدًا؛ GET، ثم /v1/groups/{groupId}/devices تُدرج أعضاء المجموعة.
تضييق نطاق النتائج
تصفية الأجهزة حسب companyId، وsiteId، والحالة، والاسم. تُضيّق عوامل التصفية نطاق ما يمكن لبيانات اعتمادك رؤيته بالفعل. بالنسبة للقوائم المستندة إلى المؤشر، مرّر قيمة next المُعادة كـ after، مع الاحتفاظ بعوامل التصفية نفسها، وتوقف عندما تصبح next هي null. GET يُظهر /v1/operations/capabilities صلاحيات بيانات اعتمادك.
قراءة المخزون والتنبيهات
يُعيد كل من GET و/v1/devices/{deviceId}/inventory و/software التقارير المخزنة: تحقق من طوابعها الزمنية. القيمة الفارغة تعني غير معروف؛ وقائمة التجميع الفارغة تعني عدم العثور على أي شيء. للاطلاع على المخزون التفصيلي، ابدأ من /v1/devices/{deviceId}/inventory/manifest واتبع أسماء الأقسام وnextOffset. يتضمن GET و/v1/alerts التنبيهات المفتوحة والمؤكدة افتراضيًا؛ استخدم state=all لتضمين التنبيهات التي تم حلها.