hosting

GET `/v1/sites/{siteId}/quota/resources`

What this site is allowed per resource, what it is using, and what more costs.

احراز هویت

یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز sites.view باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد می‌شود، نه 404.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/quota/resources \
  -H "Authorization: Bearer zdk_live_…"

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

The **lifecycle** view, where `GET /v1/sites/{siteId}/quota` is the live read of what the box is enforcing right now. Owner ruling 2026-08-16: a plan grants **site slots**; disk, inodes and bandwidth are **per-site** resources with an admin-set default and a paid per-site upgrade. Each entry decomposes the allowance into `base` (the site's own copied default), `granted` (live grants — staff gestures and purchased upgrades) and `total`, because a card showing only the total cannot explain why the number changed when a grant expired. `reverts_at` is when the ceiling next **drops** because a temporary grant ends, so a customer learns before it happens rather than after. `measured_at` is surfaced deliberately: a bar drawn from a two-day-old reading looks identical to one drawn from a fresh reading, and `null` means nothing has ever measured this site. `price_minor` is `null` when no price is published in the caller's currency, and the client must then offer **no upgrade control** rather than one that cannot complete. Only resources this site's driver can actually enforce are listed. On a managed shared package the disk ceiling belongs to the package *type* and an inode limit does not exist at any level, so the list is empty there — the control is absent rather than inert. Requires `sites.view`.

پارامترها

نام	نوع	الزامی	چیست
`siteId (path)`	`Uuid`	بله	Site ID (UUIDv7).

پاسخ

نام	نوع	الزامی	چیست
`frozen`	`boolean`	بله	Whether the platform has restricted this site for being over a quota. It is deliberately not "is this site restricted": that rung is shared with the malware and abuse ladder…
`resources`	`SiteQuotaResource[]`	بله	Only resources this site's driver can actually enforce. Empty on a managed hosting package, where the disk ceiling belongs to the package type and inodes do not exist.

خطاهایی که این نقطه پایانی می‌تواند برگرداند

401 · 403 · 404 · 429

GET /v1/sites/{siteId}/quota/resources