# GET /v1/notifications/prefs

Lấy tuỳ chọn thông báo

Những sự kiện thông báo đang bật trên từng kênh. Chỉ đổi được trên web (người đăng nhập). Trường `report_hour` cho biết giờ gửi báo cáo hằng ngày theo múi giờ tài khoản (0–23). Chỉ hiển thị kênh Telegram khi trợ lý tự động đã bật. 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ố

Không có tham số.

## Phản hồi

```
{ items: { channel: "email" | "telegram" | "webhook" | "webpush"; enabled: boolean; event_type: "payout.upcoming" | "payout.status_changed" | "hold.created" | "hold.decided" | "dispute.replied" | "kyc.status_changed" | "zone.quality_changed" | "ivt.threshold_exceeded" | "zone.traffic_stopped" | "zone.traffic_resumed" | "day.finalized" | "report.daily" | "site.status_changed" | "referral.credited" | "support.replied" | "webhook.endpoint_disabled" | "account.security" | "ping"; locked: boolean }[]; report_hour?: 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. |

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