POST AI agent ready /v1/site/performance

API de performances du site - TTFB, redirections et contrôle de compression

Récupère une URL et mesure le temps jusqu'au premier octet (TTFB), le temps de réponse total, l'encodage du contenu (gzip, brotli ou aucun), le nombre de redirections, la chaîne de redirection à chaque saut, le code d'état HTTP, l'en-tête du serveur et les métadonnées du contenu. Utile pour la surveillance des performances, les portes CI/CD et le débogage des chargements de pages lents.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/site/performance \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

When to use this API

Tableaux de bord de surveillance de la disponibilité

Interrogez ce point de terminaison toutes les minutes pour connaître vos URL de production. Suivez TTFB et total_time_ms au fil du temps. Alerte lorsque TTFB dépasse votre seuil SLA ou lorsque status_code n'est pas 200.

Portes de performances CI/CD

Appelez ce point de terminaison après le déploiement sur la zone intermédiaire. Faites échouer le pipeline si le TTFB dépasse 500 ms ou si la compression est désactivée. Détectez les régressions de performances avant qu’elles n’atteignent la production.

Débogage de la chaîne de redirection

Transmettez une URL et inspectez le tableau redirect_chain pour voir chaque saut, code d'état et timing. Identifiez les redirections inutiles qui ajoutent de la latence. Coupables courants : redirections HTTP vers HTTPS, www vers non www et barre oblique finale.

Frequently asked questions

Que mesure le TTFB ?

Le temps jusqu'au premier octet (TTFB) est le temps en millisecondes entre l'envoi de la requête HTTP et la réception du premier octet de la réponse. Il inclut la résolution DNS, la connexion TCP, la négociation TLS et le temps de traitement du serveur.

Est-ce que cela exécute JavaScript ou affiche la page ?

Non. Ce point de terminaison mesure la réponse HTTP, pas le rendu côté client. Il chronomètre la réponse du serveur et inspecte les en-têtes. Pour les performances de rendu JavaScript, utilisez un outil basé sur un navigateur tel que Lighthouse.

D'où est envoyée la demande ?

Les requêtes sont envoyées depuis les nœuds périphériques Cloudflare Workers. Le centre de données Cloudflare le plus proche gère la demande, donc TTFB reflète la latence entre ce nœud périphérique et le serveur cible.

Combien de redirections suit-il ?

Le point de terminaison suit jusqu'à 10 redirections. Chaque redirection est enregistrée dans le tableau redirect_chain avec son URL, son code d'état et son timing. Si la chaîne dépasse 10 sauts, la requête échoue avec une erreur de boucle de redirection.

Puis-je tester des pages authentifiées ?

Non. Le point de terminaison envoie une requête GET standard sans cookies ni en-têtes d’authentification. Il mesure les performances des pages accessibles au public uniquement.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.