Latency

GET/api/v1/latency

Lit l'historique de plusieurs Agents de latence externe vers une cible TCP publique. La propre latence de Cloudflare n'est pas dans cette réponse ; utilisez Status ou Checks.

Paramètres de requête

Paramètre	Requis	Défaut	Plage	Rôle
target_id	oui	—	ID de cible TCP publique	cible sondée
hours	non	24	1–168	fenêtre d'historique

curl -fsSL 'https://YOUR-API/api/v1/latency?target_id=vps-a&hours=24'

Structure de réponse

{
  "ok": true,
  "target_id": "vps-a",
  "sources": [
    {
      "id": "home-shanghai",
      "name": "Shanghai Telecom",
      "kind": "external",
      "points": [
        {
          "checked_at": 1760000000,
          "latency_ms": 28.4,
          "ok": true
        }
      ]
    }
  ]
}

sources[]

Chaque source est un nœud de latence créé dans le panneau d'administration qui a réellement soumis des résultats. Créer l'enregistrement ne produit aucune donnée ; le nœud n'entre dans l'historique qu'après que sa commande d'installation a terminé la première soumission.

Quand target_id manque, que la cible n'existe pas ou est désactivée, l'implémentation de compatibilité peut renvoyer HTTP 200 avec ok: false et error. Les clients doivent vérifier ok JSON.

latency_sources dans Status ne garde que les dernières sources dans la fenêtre de fraîcheur ; cet endpoint renvoie l'historique dans hours. « Des points anciens dans l'historique mais pas de nœud dans la légende » signifie généralement que le nœud a cessé de rapporter.

Ordre de dépannage

Si le frontend n'affiche que Cloudflare :

1. Vérifiez que le nœud est activé avec un « dernier rapport » récent dans le panneau.
2. Vérifiez systemd et le journal sur le nœud.
3. Lancez --once manuellement et confirmez accepted > 0.
4. Confirmez que la cible est une cible TCP publique activée sans adresse masquée.
5. Attendez que le court cache d'état se rafraîchisse, puis vérifiez sources ici.

Les nouvelles commandes d'installation font nettoyer les anciens processus par l'installeur ; redémarrer simplement un ancien nœud peut continuer à utiliser des scripts, ID de nœud ou jetons obsolètes.

Le cache par défaut est de 30 s avec target_id et hours dans la clé. Seules les sources externes sont renvoyées ; la latence Cloudflare courante vient de Status et l'historique de Checks.