hosting
GET /v1/sites/{siteId}/resource-usage
Get the vendor's own counts of what a package is using.
المصادقة
أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن sites.view؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.
لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.
جربه الآن
استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/resource-usage \
-H "Authorization: Bearer zdk_live_…"هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API
التفاصيل
How many cron jobs, FTP accounts, databases, database users, aliases and SSH keys the package currently holds, counted by the vendor rather than by us. This is the honest denominator behind every *"3 of 5"* caption on the hosting tab: a count we derived from our own list would disagree with the package the moment anything was created outside this platform. ⛔ A count the vendor sent in a form we could not read is **named in `unreadable`** and reported as `0`, never silently folded into the number. A caption built on a zero that means "we could not tell" is worse than no caption. Requires `sites.view` — the same class of fact as the disk and bandwidth figures beside it. `404` for a site with no managed hosting package.
المعلمات
| الاسم | النوع | مطلوب | ما هو هذا |
|---|---|---|---|
siteId (path) | Uuid | نعم | Site ID (UUIDv7). |
الاستجابة
| الاسم | النوع | مطلوب | ما هو هذا |
|---|---|---|---|
cron_jobs | integer | نعم | Scheduled tasks on the package. |
ftp_accounts | integer | نعم | FTP accounts on the package, including its primary one. |
mysql_databases | integer | نعم | MySQL databases on the package. |
mysql_users | integer | نعم | MySQL users on the package. |
server_aliases | integer | نعم | Domain aliases pointed at the package. |
ssh_public_keys | integer | نعم | SSH public keys installed on the package. |
unreadable | string[] | نعم | ⛔ Counts the vendor sent in a form we could not read. They are **named here and reported as 0** above, never silently folded into the number — a caption built on a zero that mea… |
الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه
401 · 403 · 404 · 429 · 503