# GET /v1/quality/ivt

Lấy báo cáo IVT

Số lượt yêu cầu, hợp lệ và bị lọc theo vùng quảng cáo, ngày EST cố định (UTC−5), kèm lý do IVT. Khoảng ngày gồm hai đầu, tối đa 92 ngày. vùng quảng cáo phải thuộc nhà xuất bản đang đọc. Cần quyền `publisher:read` (khoá API hoặc phiên web). Tầng giới hạn tốc độ: `read`.

- Quyền cần có: `publisher:read`
- Giới hạn tốc độ: `read` — 120 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc |
|---|---|---|---|
| `from` | query | string | có |
| `to` | query | string | có |
| `zone_id` | query | integer | không |

## Phản hồi

```
{ 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 }[] }
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |
| 400 | Default Response |
| 404 | Default Response |

Tài liệu HTML: https://agimone.com/vi/developers/api/#get-ivt-report
API 2026-10
