Checks

GET/api/v1/checks

Lit les enregistrements de disponibilité, les points quotidiens et la série de disponibilité Agent correspondante pour une cible. Adapté aux grilles SLA, courbes de latence et chronologies de panne.

Paramètres de requête

Paramètre	Requis	Défaut	Plage	Rôle
target_id	oui	—	ID de cible publique valide	cible
hours	non	72	1–720	fenêtre d'historique, max 30 jours
limit	non	864	plafond 12000, ajustable au déploiement 100–20000	max de points de sonde

curl -fsSL 'https://YOUR-API/api/v1/checks?target_id=vps-a&hours=72&limit=864'

Structure de réponse

{
  "ok": true,
  "source": "d1-check-buckets",
  "checks": [],
  "daily_points": [],
  "agent_series": []
}

Champ	Rôle
checks[]	points de sonde Cloudflare dans la fenêtre, du plus récent au plus ancien
daily_points[]	données d'affichage quotidiennes calculées depuis les buckets
agent_series[]	historique de disponibilité de l'Agent ; pas les sondes Cloudflare
source	source de stockage d'historique courante

Un target_id manquant renvoie HTTP 400. Les cibles inexistantes, désactivées ou à adresse masquée peuvent renvoyer un historique vide ; jugez depuis la liste des cibles Status et les champs de confidentialité, sans retomber sur l'API admin.

Conseils de graphiques

1. Copiez et triez par checked_at croissant pour les courbes.
2. Ne simulez pas 0 ms pour les points ok = false.
3. À la réinitialisation du zoom, restaurez les vrais premiers/derniers horodatages.
4. Avec moins de deux points, affichez un état à point unique plutôt qu'une tendance étirée.
5. Utilisez des légendes et étiquettes séparées pour les sondes Cloudflare et agent_series.

Cache

Le target_id, hours et limit normalisés forment la clé de cache. Le cache par défaut est d'environ 60 s, réglable de 0 à 300 s ; la réponse porte X-NIE-SLA-Cache: hit|miss et conserve X-NStatus-Cache pendant v1. N'ajoutez pas de paramètres sans signification.