hosting

GET `/v1/uptime/monitors/{monitor_id}`

One monitored address, with its history.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

curl -X GET https://api.zinndigital.com/v1/uptime/monitors/{monitor_id} \
  -H "Authorization: Bearer zdk_live_…"

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

The monitor, its hourly uptime and response-time history, its incidents, its Core Web Vitals readings, and — when its measured health warrants one — a migration offer. ⛔ Unknown ids answer **404, never 403**: a 403 would confirm the id exists and belongs to somebody else. Gated on `sites.view`.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`monitor_id (path)`	`string`	نعم	—
`hours (query)`	`integer`	لا	How many hourly history points to return.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`id`	`string`	نعم	—
`url`	`string`	نعم	—
`name`	`string`	لا	—
`state`	`string<unknown, up, down, paused>`	نعم	⛔ `unknown` is a real state and is not a synonym for `up` — it means "not checked yet" and is excluded from every uptime percentage.
`enabled`	`boolean`	نعم	—
`expect_text`	`string`	لا	—
`site_id`	`string`	لا	Set only when the address happens to be one of this organisation's own sites. Navigation only — the monitor works identically without it, and must, because the product exists to…
`last_result_at`	`string`	لا	—
`last_up_at`	`string`	لا	—
`last_down_at`	`string`	لا	—
`created_at`	`string`	نعم	—
`summary`	`UptimeSummary`	لا	—
`history`	`UptimeHistoryPoint[]`	لا	—
`incidents`	`UptimeIncident[]`	لا	—
`vitals`	`UptimeVitalsPoint[]`	لا	—
`migration_offer`	`UptimeMigrationOffer`	لا	—

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 404

GET /v1/uptime/monitors/{monitor_id}