إحصاءات الاستخدام

curl -G "https://qcg-api.scanova.io/console/usage/" \
  -H "Authorization: Bearer <your_oauth_access_token>" \
  -d environment=live \
  -d period=month

{
  "total_requests": 4820,
  "successful_requests": 4761,
  "failed_requests": 59
}

GET

console

usage

curl -G "https://qcg-api.scanova.io/console/usage/" \
  -H "Authorization: Bearer <your_oauth_access_token>" \
  -d environment=live \
  -d period=month

{
  "total_requests": 4820,
  "successful_requests": 4761,
  "failed_requests": 59
}

يعيد إجماليات عدد الطلبات لبيئة مفتاح معينة ضمن نافذة زمنية متحركة. مثل بقية نقاط نهاية console/، تقع هذه على مضيف Scanova API العادي (‏qcg-api.scanova.io)، مصادَقًا عليها برمز وصول OAuth الخاص بلوحة التحكم.

الأرقام مُجمَّعة عبر كل مفتاح يشارك environment المحددة في حسابك، وليس لمفتاح واحد. إذا أردت الإجمالي مدى الحياة لمفتاح واحد، فهذا هو حقل usage_count الذي تعيده GET /console/token/.

الطلب

GET https://qcg-api.scanova.io/console/usage/
Authorization: Bearer <your_oauth_access_token>

string

مطلوب

واحد من sandbox، live، zapier، mcp. يحدد سجلات أي المفاتيح تُجمَّع.

string

افتراضي:"week"

واحد من day، week، month، year. النافذة الزمنية المتحركة المنتهية الآن التي تُحصى الطلبات ضمنها.

curl -G "https://qcg-api.scanova.io/console/usage/" \
  -H "Authorization: Bearer <your_oauth_access_token>" \
  -d environment=live \
  -d period=month

{
  "total_requests": 4820,
  "successful_requests": 4761,
  "failed_requests": 59
}

حقول الاستجابة

integer

إجمالي الطلبات المسجَّلة للمفاتيح في هذه البيئة ضمن النافذة الزمنية.

integer

الطلبات التي أعادت رمز حالة أقل من 400.

integer

الطلبات التي أعادت رمز حالة 400 أو أعلى.

الأخطاء

environment مطلوبة — حذفها، أو تمرير قيمة خارج القيم الأربع المذكورة أعلاه، يعيد:

400 Bad Request

{ "environment": ["A valid environment is required."] }

قيمة period غير صالحة تعيد:

400 Bad Request

{ "period": ["period must be one of day, week, month, year."] }

لا توجد حاليًا أي حدود معدل (rate limits) مفروضة على Management API — نقاط نهاية الاستخدام هذه موجودة لأغراض الرؤية فقط، لا لفرض حصة. راجع الاستخدام اليومي للاطلاع على اتجاه يومي والاستخدام حسب نقطة النهاية للاطلاع على تفصيل حسب المسار.

البدء

واجهة الإدارة — الرموز والاستخدام

واجهة الإدارة — رموز QR

واجهة الإدارة — المجلدات والوسوم

واجهة الإدارة — المستخدمون المشتركون والأدوار

واجهة الإدارة — العملاء المحتملون والنماذج

واجهة الإدارة — التحليلات والخطط

الطلب

حقول الاستجابة

الأخطاء

ذات صلة

التفويضات

معلمات الاستعلام

الاستجابة

​الطلب

​حقول الاستجابة

​الأخطاء

​ذات صلة

التفويضات

معلمات الاستعلام

الاستجابة

الطلب

حقول الاستجابة

الأخطاء

ذات صلة