hosting
GET /v1/site-imports/snapshots
What a web archive holds for a domain, by day.
احراز هویت
یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز sites.view باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد میشود، نه 404.
این نقطه پایانی هیچ شناسه سازمانی را دریافت نمیکند. کلید شما در حال حاضر سازمان مربوطه را مشخص میکند و پاسخ در همان محدوده ارائه میشود.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/site-imports/snapshots?domain=<domain> \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی 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 t… |
error | string | بله | Why the last refresh failed; empty when it did not. |
fetched_at | string | خیر | — |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 422 · 429