احراز هویت
یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز sites.view باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد میشود، نه 404.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/databases \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی API زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید
جزئیات
The MySQL databases on the site's hosting package, with the user bound to each so a connection string can be assembled. **No password is returned**: a database password exists in exactly one response on this platform, the one that created it, and there is no endpoint that reads one back. `limit` is the effective ceiling — the lower of what the package permits and what the customer bought. `permitted` and `can_create` answer the two different questions a screen must distinguish before it offers an "add" button. This is the customer's own control surface. It is deliberately **not** a link to any vendor database tool: no customer is ever sent to a vendor control panel (docs/62 §3.7). `404` for a site with no vendor hosting package. Requires `sites.view`.
پارامترها
| نام | نوع | الزامی | چیست |
|---|---|---|---|
siteId (path) | Uuid | بله | Site ID (UUIDv7). |
پاسخ
| نام | نوع | الزامی | چیست |
|---|---|---|---|
data | SiteHostingDatabase[] | بله | The databases on the package. |
limit | VendorAllowance | بله | The effective ceiling on databases for this site. |
permitted | boolean | بله | Whether the package type includes databases at all. |
can_create | boolean | بله | `permitted`, **and** the effective ceiling has room. |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 404 · 429 · 503