استعلام استهلاك الباندويث

جلب إحصائيات استهلاك البيانات والوسائط الشهري (التحميل، الرفع، والبيانات الموفرة) لجميع الجلسات أو لجلسة محددة.

GET
https://api.wawp.net/v2/usage/bandwidth?access_token=YOUR_ACCESS_TOKEN&instance_id=123456789&month=2026-11

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول
اختبار /v2/usage/bandwidth
GETPOST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

توصيات

  • راقب القيمة 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 Body
string—

معرف الجلسة (اختياري) لتصفية الاستهلاك لجلسة محددة، أو اتركه فارغاً لعرض إجمالي الحساب.

مثال:
string

رمز الوصول الخاص بواجهة البرمجة (Access Token).

مثال:
string—

شهر الفوترة بصيغة YYYY-MM (الافتراضي هو الشهر الحالي).

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/usage/bandwidth";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "YOUR_ACCESS_TOKEN",
6 "month": "2026-11"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11 method: "GET",
12 headers: { "Content-Type": "application/json" },
13
14})
15 .then(async (response) => {
16 if (response.ok) {
17 const data = await response.json();
18 console.log("Success:", data);
19 return data;
20 }
21
22 // Error Handling
23 if (response.status === 400) {
24 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
25 }
26 if (response.status === 401) {
27 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
28 }
29 if (response.status === 500) {
30 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
31 }
32
33 const errorText = await response.text();
34 console.error(`Error ${response.status}: ${errorText}`);
35 })
36 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 36, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Bandwidth usage retrieved successfully
application/json
string *
string *
number *
string *
object *
object *

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...