Status
/api/v1/statusRenvoie les cibles publiques, l'état courant, les résumés SLA, les incidents, l'apparence frontend, les cibles de ping et la dernière télémétrie Agent. C'est le point d'entrée principal des frontends alternatifs.
Paramètres de requête
| Paramètre | Requis | Défaut | Plage | Rôle |
|---|---|---|---|---|
days | non | défaut serveur | 1–90 | résumé quotidien et étendue SLA |
lite | non | 0 | 0 ou 1 | 1 renvoie des données adaptées au premier affichage |
curl -fsSL 'https://YOUR-API/api/v1/status?days=30&lite=1'Champs de premier niveau
| Champ | Rôle |
|---|---|
name | nom public du site |
now | heure ISO du serveur |
days | liste des dates de la réponse |
regions | code de région vers nom affiché |
region_proxy_enabled | binding Durable Object régional |
frontend_theme | nom du thème intégré |
frontend | réglages d'apparence filtrés publiquement |
traffic | description de la période de trafic courante |
privacy | politique publique sur IP, ports, datacenter |
storage | capacités de stockage et TTL de cache |
timezone | fuseau d'agrégation SLA |
targets[] | profils de cibles, sondes courantes, état Agent, sources de latence |
summaries[] | agrégation SLA quotidienne par cible |
incidents[] | événements récents de panne/rétablissement |
ping_targets[] | cibles de ping TCP Agent activées |
warnings[] | avertissements de synchronisation ou de données non fatals |
Champs clés de targets[]
id,name,group_name,type: identité et classification stables.location,city,provider,line_type: profil public.ok,checked_at,latency_ms: sonde Cloudflare courante.agent_online,last_metrics_at,agent_version: état de l'Agent Rust.agent_metrics: dernières métriques système filtrées publiquement.latency_sources[]: sources Cloudflare et externes dans la fenêtre de fraîcheur.has_nq,nq: existence d'un rapport NodeQuality et sa date.unlock: résultats de service désensibilisés d'une vérification de déblocage IPv4 manuelle.no_public_ip: masque l'IP de la cible, le port et les données de latence actives.
ok est la sonde active Cloudflare ; agent_online indique si l'Agent de métriques a rapporté récemment. Affichez-les séparément ; ne laissez pas l'un écraser l'autre.
agent_metrics.vps_info.total_disk_gb est la capacité du système de fichiers racine, pas une somme des montages ; les bind mounts du même périphérique ne sont pas comptés deux fois.
Mode lite
Demandez lite=1 pour le premier affichage, puis chargez checks, metrics, pings ou latency à l'ouverture des détails. Lite conserve cibles, résumés, incidents, politique de confidentialité, apparence et avertissements, mais retire les détails par jour des cibles et les champs lourds comme agent_metrics.pings.
Heure et ordre
L'heure serveur peut différer de celle du client. Utilisez now comme référence pour calculer « vient de rapporter » ; triez explicitement les tableaux d'historique par horodatage numérique.
Confidentialité
Le serveur masque les IP, cache les ports, retire les identifiants d'URL et supprime les détails d'erreur interne selon les réglages du déploiement. N'essayez pas de reconstruire ces données depuis d'autres champs publics et ne mettez pas en cache des données d'API admin comme substitut de l'état public.
Pour les cibles TCP avec no_public_ip, les sondes Cloudflare et la latence externe sont masquées, status_source devient Agent, et ok/checked_at/latency_ms peuvent valoir null. N'affichez que l'état en ligne de l'Agent ; n'interprétez pas null comme une panne.
Cache et avertissements
Le cache d'état par défaut est d'environ 20 s, réglable de 0 à 300 s. L'API publique v1 ne peut pas le contourner avec fresh=1 ; seules les requêtes d'état internes avec une session admin valide forcent le rafraîchissement. warnings[] signifie que des sources optionnelles ont dégradé ; les cibles principales s'affichent toujours.