hosting
GET /v1/sites/{siteId}/apm
Ranked transactions, ranked hotspots and the hourly timeline for a site.
身份验证
请将 API 密钥作为 bearer 令牌发送。该密钥必须具有 sites.view 权限；缺少该权限的密钥将被拒绝并返回 403 状态码，而非 404。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/apm \
-H "Authorization: Bearer zdk_live_…"已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
Stored, aggregated PHP profiling: which **pages** cost the most server time, which **plugin, PHP function or SQL query** is eating it, and how the site's PHP execution time has moved hour by hour. ⭐ Read from rows, not from the machine. The sibling `…/performance/slow-requests` surface opens an SSH session to the worker box on every call; this one is a database query, which is why it can be rendered on a customer-facing tab without a §2.16 problem. ⛔ **An empty payload is a `200` WITH A REASON.** `enrolment_state` says which of four things happened — `unknown` (not collected yet), `enrolled` (collected, and the site was genuinely quiet), `refused` (the server would not start tracing), `unsupported` (hosting that cannot trace). A surface that cannot tell a quiet site from a feature that is switched off was the live state of the fleet on 2026-09-03: one of two boxes had zero sites enrolled and every screen said "nothing traced yet". Requires `sites.view` and the `request_profiling` entitlement, which is included on every product line. No visitor IP addresses appear in the response — the field does not exist at any layer beneath this one.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
siteId (path) | Uuid | 是 | Site ID (UUIDv7). |
hours (query) | integer | 否 | How far back to aggregate (1–2160, default 24). Clamped rather than refused: a junk value answers the question that was asked with the default period. |
limit (query) | integer | 否 | How many ranked rows per table (1–50, default 10). |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
tracing | boolean | 是 | Whether the server is currently profiling this site. |
enrolment_state | string<unknown, enrolled, refused, unsupported> | 是 | Why there may be no data. `unknown` — not collected yet. `enrolled` — collected, and the site was genuinely quiet. `refused` — the server would not start profiling. `unsupported… |
enrolment_detail | string | 是 | The server's own sentence when it refused; empty otherwise. |
last_collected_at | string | 是 | When we last harvested this site, or null if never. |
window_hours | integer | 是 | The period these aggregates cover. |
p95_duration_ms | integer | 是 | The 95th percentile of PHP time across EVERY request traced for this site in the window, in milliseconds. ⚠️ This is the customer's OWN traffic. It is a different quantity from… |
p95_sample_count | integer | 是 | How many requests `p95_duration_ms` was computed over. Shipped WITH it, always: a p95 over 30 requests and one over 30,000 are indistinguishable on screen otherwise (§2.44). |
transactions | SiteApmTransaction[] | 是 | Pages ranked by total PHP time, heaviest first. |
hotspots | SiteApmHotspot[] | 是 | Plugins, functions and queries ranked by total PHP time. |
timeline | SiteApmTimelinePoint[] | 是 | PHP execution time by hour, oldest first. |
此端点可能返回的错误
401 · 403 · 404 · 422 · 429