hosting
GET /v1/sites/{siteId}/cdn/analytics
Read edge traffic for a site's CDN zone.
احراز هویت
یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز sites.view باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد میشود، نه 404.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/cdn/analytics \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی API زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید
جزئیات
Daily requests, bytes, threats and unique visitors as counted **at the CDN edge**. This is not the same measurement as `/v1/sites/{siteId}/cdn/statistics`, and the two will not agree. That endpoint reports the hosting platform's own edge cache for a site on a managed hosting plan; this one reports the Cloudflare zone's. A site may have one, the other, both or neither, and they are counted at different edges — collapsing them into one number would invent a figure that is true of neither. Requires `sites.view`.
پارامترها
| نام | نوع | الزامی | چیست |
|---|---|---|---|
siteId (path) | Uuid | بله | Site ID (UUIDv7). |
days (query) | integer | خیر | How many days to report, clamped to 1–30. Clamped rather than trusted: this is reachable from a screen a customer can refresh, against a provider API whose request budget is sha… |
پاسخ
| نام | نوع | الزامی | چیست |
|---|---|---|---|
site_id | Uuid | بله | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
supported | boolean | بله | — |
days | CdnTrafficDay[] | بله | Most recent first. |
total_requests | integer | بله | — |
total_threats | integer | بله | — |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 404 · 429 · 503