احراز هویت
یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز sites.view باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد میشود، نه 404.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/scheduled-tasks \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی API زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید
جزئیات
The cron jobs on the site's hosting package: when each runs, what it runs, whether it is paused, and where its output is mailed. `schedule` is the customer's own crontab expression carried verbatim — a customer who typed `*/15 * * * *` sees exactly that back, never a normalised rewriting of it. `permitted` and `can_create` answer the two different questions a screen must distinguish before it offers an "add" button: *"your plan does not include this"* is not *"you have used all of them"*. ⛔ the platform publishes scheduled tasks as a **boolean** capability with no count, so `limit` is normally unlimited and `can_create` follows `permitted` rather than an arithmetic on a ceiling nobody published. Requires `sites.view` **and** `sites.panel_access` — a cron row is a filesystem path plus a command run as the site's user, which is the same access the file manager that key already gates. ⭐ Available on **both** a resold hosting package and a site on Zinn®'s own fleet, including Footprint-Free. That matters for a footprint site in particular: WordPress's own scheduler only fires when somebody visits, and a footprint site by design has very few visitors, so its scheduled publishing and index-ping jobs would otherwise run late or not at all. Every fleet site is given a real system cron entry at deploy, and the jobs listed here are the customer's own — the platform's are held separately and are never listed, edited or deleted through this endpoint.
پارامترها
| نام | نوع | الزامی | چیست |
|---|---|---|---|
siteId (path) | Uuid | بله | Site ID (UUIDv7). |
پاسخ
| نام | نوع | الزامی | چیست |
|---|---|---|---|
data | SiteScheduledTask[] | بله | The cron jobs on the package. |
limit | VendorAllowance | بله | The effective ceiling on scheduled tasks. ⛔ the platform publishes this capability as a **boolean with no count**, so it is normally unlimited — `can_create` must not be derived… |
permitted | boolean | بله | Whether the package type includes scheduled tasks at all. |
can_create | boolean | بله | `permitted`, **and** the effective ceiling has room. |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 404 · 429 · 503