domains
POST /v1/domain-watches/{watchId}/mute
Silence a watched domain's alerts without removing it.
احراز هویت
یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمیکند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X POST https://api.zinndigital.com/v1/domain-watches/{watchId}/mute \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی API زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید
جزئیات
⚖️ Owner 2026-08-30: *"can be removed at anytime or silenced at least."* ⛔ A muted watch is **still checked** and its history still recorded — only its notifications are suppressed. Skipping the read would leave a hole, so un-muting would produce a burst of "changes" that are simply everything that happened while nobody was listening. Send `until: null` to un-mute.
پارامترها
| نام | نوع | الزامی | چیست |
|---|---|---|---|
watchId (path) | string | بله | — |
بدنه درخواست
| نام | نوع | الزامی | چیست |
|---|---|---|---|
until | string | خیر | Suppress alerts until this instant. `null` un-mutes. |
پاسخ
| نام | نوع | الزامی | چیست |
|---|---|---|---|
id | string | بله | — |
fqdn | string | بله | Normalised lowercase punycode. |
source | string<registered, hosting, manual> | بله | How it came to be watched. `registered` — we hold it. `hosting` — it is attached to a hosting account with us, whoever registered it. `manual` — the customer added it. ⛔ A domai… |
domain_id | string | خیر | The `Domain` row, when the watched name is one of ours. |
site_id | string | خیر | — |
muted | boolean | بله | Whether alerts are currently suppressed. |
muted_until | string | خیر | — |
expires_at | string | خیر | ⛔ `null` is **"the registry did not say"**, never "it does not expire". Render it as unknown; a client that treats it as a far-future date shows a customer a reassuring answer w… |
days_until_expiry | integer | خیر | Whole days, or `null` when `expires_at` is unknown. |
registrar | string | خیر | As the registry reports it. Empty when redacted or not yet read. |
nameservers | string[] | خیر | — |
status | string[] | خیر | The EPP status set — `clientHold`, `redemptionPeriod`, `pendingDelete`, … |
last_checked_at | string | خیر | When the registry last answered. ⛔ Every value on this row is a snapshot of the outside world taken at this instant, so it is never rendered without this beside it (§2.36). |
created_at | string | بله | — |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 404 · 422