curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
واجهة الإدارة — الرموز والاستخدام
الاستخدام حسب نقطة النهاية
GET /console/usage/by-endpoint/
GET
/
console
/
usage
/
by-endpoint
/
curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
يعيد أعداد الطلبات مُجمَّعة حسب نقطة النهاية وطريقة HTTP — مفيد لمعرفة أي أجزاء من Management API يستخدمها تكامل فعليًا. يقع على مضيف Scanova API العادي (
qcg-api.scanova.io)، مصادَقًا عليه برمز وصول OAuth الخاص بلوحة التحكم.
الطلب
GET https://qcg-api.scanova.io/console/usage/by-endpoint/
Authorization: Bearer <your_oauth_access_token>
string
مطلوب
واحد من
sandbox، live، zapier، mcp. يحدد سجلات أي المفاتيح تُجمَّع.curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
حقول الاستجابة
الاستجابة مصفوفة، عنصر واحد لكل زوج(endpoint, method) مميز شوهد في السجلات، مرتَّبة تنازليًا حسب count.
string
رابط الطلب الكامل الذي سُجِّل، بما في ذلك القيمة الفعلية لمعلمة المسار (مثل
qrid محدد) — وليس قالب مسار موحَّدًا. توقع عناصر مميزة كثيرة للمسارات ذات معلمات المسار إذا استدعيتها بمعرّفات مختلفة.string
طريقة HTTP الخاصة بالطلب، مثل
GET، POST، PUT، DELETE.integer
إجمالي الطلبات المسجَّلة لزوج نقطة النهاية/الطريقة هذا.
number
النسبة (
0–1) من الطلبات إلى زوج نقطة النهاية/الطريقة هذا التي أعادت رمز حالة 400 أو أعلى.خلافًا لـ إحصاءات الاستخدام والاستخدام اليومي، لا تملك نقطة النهاية هذه نافذة
period/days — إنها تُجمِّع عبر كامل فترة الاحتفاظ بالسجلات (تُحذف سجلات الطلبات بعد 6 أشهر).الأخطاء
environment مطلوبة، نفس التحقق الموجود في إحصاءات الاستخدام.
ذات صلة
- إحصاءات الاستخدام — نفس الحركة كإجمالي واحد ضمن نافذة متحركة بدلًا من تفصيل حسب نقطة النهاية.
- الاستخدام اليومي — نفس الحركة مُفصَّلة حسب اليوم التقويمي بدلًا من المسار.
- نظرة عامة على Management API — قيم
environment(sandbox،live،zapier،mcp) التي تُجمِّع نقطة النهاية هذه بحسبها.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
معلمات الاستعلام
الاستجابة
200
Usage grouped by endpoint
هل كانت هذه الصفحة مفيدة؟
⌘I