# GET /v1/stats/availability

عرض عروض الإحصاءات المتاحة

تعيد browser_available: true عندما يمكن تجميع الإحصاءات أو تصفيتها بحسب المتصفح، أو false عندما يكون هذا العرض غير متاح لإعداد الحساب. وتعيد أيضًا browser_enabled: false عندما يكون عرض المتصفح متوقفًا (أخف الخيار)، وbrowser_data_since: أول يوم عمل EST (YYYY-MM-DD) تحمل منه كل ساعة وسم متصفح، أو null عند عدم المعرفة؛ وتجمّع الزيارات الأقدم تحت other. تحقق قبل اختيار عرض المتصفح. يعيد التجميع أو التصفية غير المتاحة بحسب المتصفح الخطأ 400 breakdown_unavailable مع breakdown browser لـ JSON وCSV. تتطلب الصلاحية publisher:read (مفتاح API أو جلسة ويب). فئة حد المعدل: read.

- الصلاحية المطلوبة: `publisher:read`
- حد المعدل: `read` — 120 طلبًا لكل نافذة مدتها 60 ثانية لكل مفتاح API أو جلسة ويب

## المعاملات

لا معاملات.

## الاستجابة

```
{ browser_available: boolean; browser_data_since?: string | null; browser_enabled?: boolean }
```

## الأخطاء

تعيد المسارات الخاضعة لحد المعدل الترويسات `RateLimit-Limit` و`RateLimit-Remaining` و`RateLimit-Reset` (عدد الثواني حتى انتهاء النافذة)؛ وتحمل الاستجابة 429 أيضًا `Retry-After`. قد تغيب الترويسات أثناء عدم توفر المحدّد مؤقتًا (وتمرّر الطلبات حينئذ).

| الحالة | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح أو ملغى. |
| 403 | ينقص المفتاح الصلاحية المطلوبة، أو العملية غير مسموح بها لهذا الطرف. |
| 429 | تم تجاوز حد المعدل؛ انتظر `Retry-After` ثانية. |

وثائق HTML: https://agimone.com/ar/developers/api/#get-stats-availability
API 2026-10
