Les APIs utiles d'infrastructure
Quatre APIs d'infrastructure qui tiennent dans un curl, testées sur un VPS réel : Prometheus, Kubernetes, Cloudflare et GitHub, avec les pièges de débit.
Trois alertes sur cinq qui ont sonné sur mon téléphone le mois dernier venaient d'un seuil mal calibré, pas d'une vraie panne. Le correctif a pris un appel HTTP. Pas un dashboard, pas un clic dans une console : un curl dans un script, versionné avec le reste.
C'est ça, le vrai intérêt des APIs d'infrastructure. Elles transforment une opération manuelle en une ligne de code que tu peux relire, tester et rejouer. Voici celles que j'utilise réellement, classées par ce qu'elles rapportent.
Prometheus : l'API HTTP que tu utilises déjà sans le savoir
Chaque graphe de ton Grafana passe par /api/v1/query_range. Autant l'appeler directement quand tu veux une réponse sans interface.
Exemple concret : sortir le CPU idle moyen des quatre dernières heures, au pas de 60 secondes.
curl -sG 'http://localhost:9090/api/v1/query_range' \
--data-urlencode 'query=avg(rate(node_cpu_seconds_total{mode="idle"}[5m]))' \
--data-urlencode "start=$(date -d '-4 hours' +%s)" \
--data-urlencode "end=$(date +%s)" \
--data-urlencode 'step=60s' | jq -r '.data.result[0].values[-1][1]'L'API est active par défaut, ce qui fait d'elle la brique la plus simple à brancher sur un script de capacité. Le seul piège : envoyer des métriques exige le flag --web.enable-remote-write-receiver, et la spec Remote-Write 2.0 est encore marquée expérimentale côté Prometheus.
Si tu maintiens une instance depuis des années, le sujet n'est pas l'API mais la rétention : j'ai détaillé la mécanique dans maintenir Prometheus sur le long terme. La documentation officielle des endpoints reste prometheus.io/docs/prometheus/latest/querying/api.
Kubernetes : tout est API, même ce que tu crois cacher
kubectl n'est qu'un client HTTP poli. Chaque commande correspond à un appel que tu peux reproduire avec --raw, et c'est là que ça devient intéressant pour l'automatisation.
Un cas que je lance souvent : lire la consommation CPU réelle des nœuds sans passer par un dashboard.
kubectl get --raw "/apis/metrics.k8s.io/v1beta1/nodes" \
| jq -r '.items[] | "\(.metadata.name)\t\(.usage.cpu)"'Il faut metrics-server installé, sinon la route renvoie 404. Et si tu interroges l'API en boucle, utilise watch avec un resourceVersion plutôt qu'un GET toutes les dix secondes : tu économises l'apiserver et tu reçois les changements au lieu de les deviner.
La référence à garder sous la main : kubernetes.io/docs/concepts/overview/kubernetes-api. C'est sec, mais c'est la seule page qui liste vraiment les groupes et versions.
Cloudflare : le DNS qui tient dans un curl
Ton registrar web est une interface. L'API Cloudflare, elle, gère la zone en une requête, ce qui rend la bascule DNS scriptable et testable en préprod.
curl -s -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records" \
-H "Authorization: Bearer $CF_TOKEN" \
-H "Content-Type: application/json" \
--data '{"type":"A","name":"preprod","content":"203.0.113.10","ttl":120,"proxied":false}'Deux règles non négociables. Première : un token scopé Zone.DNS:Edit sur une seule zone, jamais la clé globale. Deuxième : prévoir la limite de débit, de l'ordre de 1 200 requêtes par cinq minutes et par utilisateur, donc pas de boucle de réconciliation toutes les secondes.
Le reste de la doc est ici : developers.cloudflare.com/api.
GitHub : ton déploiement est un POST
Un workflow_dispatch déclenché par API, c'est le moyen le plus propre de lancer un déploiement depuis un script, un cron ou un bot interne. Pas de token SSH à stocker, pas de machine à whitelister.
curl -s -X POST \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json" \
"https://api.github.com/repos/OWNER/REPO/actions/workflows/deploy.yml/dispatches" \
-d '{"ref":"main","inputs":{"environment":"staging"}}'La réponse est un 204 sans corps : c'est normal, et c'est exactement le genre de détail qui fait perdre vingt minutes à qui attend un JSON. Compte 5 000 requêtes par heure avec un token authentifié, largement suffisant pour du déploiement.
J'ai détaillé un usage proche dans les APIs essentielles pour les canary deploys. La référence REST complète est sur docs.github.com/en/rest.
Mon classement, sans langue de bois
- À brancher cette semaine : Prometheus et Cloudflare. Deux URLs, un token, et tu supprimes la moitié de tes manipulations manuelles.
- À garder pour les cas réels : l'API Kubernetes. Puissante, mais bavarde, et elle punit l'improvisation sur les
resourceVersion. - À éviter : sortir un SDK complet pour trois appels. Un
curlde quinze lignes se relit en revue, un SDK de 40 Mo non.
Le reste, les consoles propriétaires avec OAuth à quatre pattes pour lire une métrique, ne mérite pas ton temps. Si l'API demande plus de configuration que le problème qu'elle résout, elle n'est pas faite pour toi.
Commence par une seule brique. Scripte-la, mets-la dans ton dépôt d'ops, et mesure le temps que tu ne passes plus dans une interface. Le deuxième appel est toujours plus facile que le premier.