hosting
GET /v1/uptime/monitors/{monitor_id}
One monitored address, with its history.
Authentification
Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.
Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.
curl -X GET https://api.zinndigital.com/v1/uptime/monitors/{monitor_id} \
-H "Authorization: Bearer zdk_live_…"Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
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`.
Paramètres
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
monitor_id (path) | string | Oui | — |
hours (query) | integer | Non | How many hourly history points to return. |
Réponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
id | string | Oui | — |
url | string | Oui | — |
name | string | Non | — |
state | string<unknown, up, down, paused> | Oui | ⛔ `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 | Oui | — |
expect_text | string | Non | — |
site_id | string | Non | 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 | Non | — |
last_up_at | string | Non | — |
last_down_at | string | Non | — |
created_at | string | Oui | — |
summary | UptimeSummary | Non | — |
history | UptimeHistoryPoint[] | Non | — |
incidents | UptimeIncident[] | Non | — |
vitals | UptimeVitalsPoint[] | Non | — |
migration_offer | UptimeMigrationOffer | Non | — |
Erreurs que cet point de terminaison peut renvoyer
401 · 404