hosting
GET /v1/site-imports/snapshots
What a web archive holds for a domain, by day.
المصادقة
أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن sites.view؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.
لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.
جربه الآن
استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.
curl -X GET https://api.zinndigital.com/v1/site-imports/snapshots?domain=<domain> \
-H "Authorization: Bearer zdk_live_…"هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم 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