hosting
GET /v1/site-imports/snapshots
What a web archive holds for a domain, by day.
身份验证
请将 API 密钥作为 bearer 令牌发送。该密钥必须具有 sites.view 权限;缺少该权限的密钥将被拒绝并返回 403 状态码,而非 404。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织,且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值,并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/site-imports/snapshots?domain=<domain> \
-H "Authorization: Bearer zdk_live_…"已登录?您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥,并针对实时 API 运行请求,以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
The date picker's data for a Wayback restore. ⛔ A cached database read, never a live archive call. The Internet Archive's CDX index answered a two-row query in 41.9 seconds when measured on 2026-08-06, so an endpoint that blocked on it would hold a worker per customer and read as broken. When the cache is absent or stale this starts a durable refresh workflow and answers 202 with state: "pending"; poll it. state has four values and they are not interchangeable — pending (never fetched), ready (fresh), stale (usable but past its TTL, a refresh is running) and error (the archive refused, and the reason is in error). Requires sites.view.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
domain (query) | string | 是 | The domain to look up, e.g. example.com. www. is ignored. |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
domain | string | 是 | — |
state | string<pending, ready, stale, error> | 是 | Four states, and they are not interchangeable — collapsing error into pending leaves a customer watching a spinner for something that will never arrive. |
days | ArchiveSnapshotDay[] | 是 | — |
total_captures | integer | 是 | — |
truncated | boolean | 是 | True when the archive stopped short of the whole index. Reported rather than swallowed: a picker showing the first 50,000 of 400,000 captures while implying completeness tells the… |
error | string | 是 | Why the last refresh failed; empty when it did not. |
fetched_at | string | 否 | — |
此端点可能返回的错误
401 · 403 · 422 · 429