# GET /v1/quality/ivt

عرض تقرير IVT

إجماليات IVT اليومية وأسباب التصفية لهذا الناشر، بحسب المنطقة الإعلانية وتاريخ EST الثابت (UTC-5)، لما يصل إلى 92 يومًا شاملة. تتطلب `publisher:read`. فئة حد المعدل: `read`.

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

## المعاملات

| الاسم | الموضع | النوع | مطلوب |
|---|---|---|---|
| `from` | query | string | نعم |
| `to` | query | string | نعم |
| `zone_id` | query | integer | لا |

## الاستجابة

```
{ rows: { by_reason: object; capped: integer; date: string; demand_as_of: string | null; demand_ivt_amount: string | null; filtered: integer; final: boolean; ivt_rate_pre: number | null; level: "ok" | "watch" | "strict" | "limited" | "paused_quality"; paused: integer; requests: integer; sent: integer; zone_id: integer }[] }
```

## الأخطاء

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

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

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