استعلام استهلاك الباندويث
جلب إحصائيات استهلاك البيانات والوسائط الشهري (التحميل، الرفع، والبيانات الموفرة) لجميع الجلسات أو لجلسة محددة.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
راقب القيمة summary.total_mb مقارنة بـ summary.plan_bandwidth_limit_mb لتجنب تجاوز باقة الباندويث الشهرية.
استخدم /v2/session/media-settings لضبط قواعد التحميل التلقائي إذا لاحظت ارتفاع استهلاك الفيديو أو الحالات.
تحليلات استهلاك الباندويث الشهري للوسائط
توفر نقطة النهاية /v2/usage/bandwidth تفصيلاً كاملاً لاستهلاك حسابك من بيانات الوسائط لأي شهر فوترة (YYYY-MM)، بما يشمل البيانات الواردة (rx)، والصادرة (tx)، والموفرة (blocked) عبر الصور والفيديوهات والصوتيات والمستندات والحالات.
📊 المؤشرات الرئيسية
summary: إجمالي الميجابايت المستهلكة، الحد الأقصى للباقة، حجم التنزيل والرفع، وحجم البيانات التي تم توفيرها بفضل فلاتر الوسائط.breakdown: تفصيل دقيق لكل نوع من الوسائط (images,videos,audio,documents,statuses,profile_picture_requests).
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
معاملات الاستعلام والطلب (Query & Body Parameters)
تدعم التمرير عبر الرابط (Query String) أو كـ JSON Bodystring | — | معرف الجلسة (اختياري) لتصفية الاستهلاك لجلسة محددة، أو اتركه فارغاً لعرض إجمالي الحساب. مثال: | |
string | رمز الوصول الخاص بواجهة البرمجة (Access Token). مثال: | ||
string | — | شهر الفوترة بصيغة YYYY-MM (الافتراضي هو الشهر الحالي). مثال: |
برمج بالذكاء الاصطناعي باستخدام Wawp MCP
MCP READYقم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"status": "success",
"billing_month": "2026-11",
"user_id": 1,
"instance_id": "all",
"summary": {
"total_bytes": 52428800,
"total_mb": 50,
"plan_bandwidth_limit_mb": 2048,
"downloaded_rx_bytes": 31457280,
"downloaded_rx_mb": 30,
"uploaded_tx_bytes": 20971520,
"uploaded_tx_mb": 20,
"saved_blocked_bytes": 104857600,
"saved_blocked_mb": 100
},
"breakdown": {
"images": {
"rx_mb": 15,
"tx_mb": 10,
"count": 120
},
"videos": {
"rx_mb": 10,
"tx_mb": 5,
"count": 15
},
"audio": {
"rx_mb": 3,
"tx_mb": 2,
"count": 40
},
"documents": {
"rx_mb": 2,
"tx_mb": 3,
"count": 12
},
"statuses": {
"rx_mb": 0,
"count": 0
},
"profile_picture_requests": 25
}
}Command Palette
Search for a command to run...