InfraNestInfraNest
API · OAuth · Webhooks

Automatisez votre DNS, votre surveillance et vos serveurs avec une seule API

Une API REST pour tout ce que vous gérez dans InfraNest, chez chaque registraire, hébergeur DNS et cloud. Modifiez le DNS depuis un script, ouvrez une fenêtre de maintenance depuis votre CI et recevez un webhook signé quand quelque chose se passe. Essayez chaque appel d’abord dans une sandbox gratuite.

Lire la documentation développeur →Commencer gratuitement

Sandbox gratuite · Jetons API dès Pro · Votre premier appel en cinq minutes

api.infranest.io
200 OK · dry run
# Voyez ce que ferait un changement DNS, avant de le faire
curl -X POST "https://api.infranest.io/api/organizations/42/dns-zones/7/dns-records?dry_run=1" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600}'

{
  "dry_run": true,
  "zone": "northwind.com",
  "provider_push": "per_record",
  "changes": [{
    "action": "create", "before": null,
    "after": { "type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600 }
  }]
}

Ce que vous pouvez automatiser

Le travail de tous les jours, dans une seule API. Les mêmes enregistrements, moniteurs et serveurs que dans le tableau de bord.

Enregistrements DNS

Créez, modifiez et supprimez des enregistrements, appliquez des modèles et synchronisez des zones. Cherchez dans tous les enregistrements de toutes vos zones.

POST /dns-zones/{zone}/dns-records

Moniteurs

Créez un moniteur au déploiement, mettez-le en pause pendant vos travaux, et lisez ses résultats et sa disponibilité.

POST /monitoring-checks

Maintenance et incidents

Ouvrez une fenêtre de maintenance depuis votre pipeline et publiez des mises à jour d’incident sur votre page de statut.

POST /maintenance-windows

Domaines

Chaque domaine avec sa date d’expiration, son renouvellement automatique et ses serveurs de noms. Suivez-en de nouveaux, ajoutez notes et étiquettes.

GET /domains

Serveurs

Les serveurs de tous vos clouds, avec leurs dernières métriques et ce qui demande votre attention.

GET /cloud-servers/metrics-overview

Journal d’audit et rapports

Copiez le journal d’audit dans votre SIEM et récupérez le rapport mensuel de disponibilité.

GET /audit-logs

Conçue pour automatiser sans risque

Les scripts plantent, les réseaux expirent et les agents IA se trompent. L’API est faite pour ça.

Un dry run pour chaque changement DNS

Ajoutez ?dry_run=1 et voyez exactement quels enregistrements changeraient. Rien n’est enregistré ni envoyé à votre fournisseur.

Une sandbox gratuite

Des zones, moniteurs et un serveur d’exemple, où rien n’atteint un fournisseur ni Internet. Les jetons de test ne marchent que là.

Des nouvelles tentatives sans doublons

Envoyez une Idempotency-Key et une requête relancée ne s’exécute qu’une fois. Aucun enregistrement ni moniteur en double.

Des erreurs sur lesquelles coder

Chaque erreur a un code stable et une indication de ce qu’il faut faire. Les codes ne changent jamais.

Des jetons avec exactement l’accès nécessaire

Donnez à chaque script son propre jeton, en lecture ou en écriture par domaine. Si l’un fuit, il ne peut pas faire grand-chose, et vous le révoquez en un clic.

  • Lecture ou écriture par domaine : DNS, domaines, serveurs, surveillance et plus
  • Une seule organisation par défaut, toutes seulement si vous le choisissez
  • Expire après 30 à 365 jours, avec un e-mail une semaine avant
  • Limitez un jeton à l’adresse IP de votre runner CI
  • Acheter des domaines, supprimer des serveurs ou des zones et gérer les membres restent réservés à une personne dans l’app

Vous créez une intégration ? Utilisez OAuth

Ajoutez un bouton « Se connecter avec InfraNest » à votre application. Les gens se connectent, choisissent une organisation et approuvent ce que votre app peut faire. Personne ne copie de jeton, et ils peuvent retirer votre app à tout moment.

  • OAuth 2.1 avec PKCE et jetons de rafraîchissement
  • Les mêmes portées et limites que les jetons API
  • Une app ne peut jamais faire plus que la personne qui l’a approuvée
  • Listée dans Applications autorisées, retirable en un clic

Des webhooks pour les événements qui comptent

InfraNest envoie du JSON à votre URL quand quelque chose se passe : un domaine sur le point d’expirer, un moniteur qui tombe, des enregistrements DNS qui changent. Chaque requête est signée, pour vérifier qu’elle vient bien de nous. Une livraison échouée est relancée cinq fois sur une dizaine d’heures.

22 événements

domain.expiringdomain.status_changeddomain.dnssec_brokenserver.status_changedmonitor.alertdns.records_changeddns.live_mismatchcertificate.expiringcertificate.expiredcertificate.changedcertificate.weakcertificate.unexpectedcertificate.revokeddynamic_ip.changedwatched_domain.dropping_soonwatched_domain.availablewatched_domain.registeredwatched_domain.failedwatched_domain.in_auctionwatched_domain.releasedwatched_domain.renewedwatched_domain.funding_short
POSTyour-app.example/webhooks/infranest
X-InfraNest-Event: monitor.alert
X-InfraNest-Delivery: 9f6c2e1a-…
X-InfraNest-Timestamp: 1793030400
X-InfraNest-Signature-V2: sha256=5d41ab…

{
  "event": "monitor.alert",
  "created_at": "2026-10-26T09:30:00Z",
  "data": { "check_name": "Checkout flow", "status": "down", "monitor_type": "http" }
}

Demandez à votre assistant IA, ou laissez-le écrire le code

Connectez Claude ou ChatGPT au serveur MCP et posez vos questions sur votre compte en langage courant, gratuitement sur toutes les offres. Les agents de code comme Claude Code et Cursor ont une documentation faite pour eux : llms.txt, une version Markdown de chaque page et la description OpenAPI.

Voir comment fonctionne le serveur MCP →

Du code prêt à l’emploi

Open source sur GitHub. Copiez-le, modifiez-le, lancez-le.

Exemples

DNS dynamique, Let’s Encrypt DNS-01, une fenêtre de maintenance autour d’un déploiement et plus, en shell, Python, Node.js et PowerShell.

GitHub Action

Coupez les alertes pendant qu’un workflow déploie, puis rallumez-les.

Postman, Bruno et Insomnia

Chaque endpoint, prêt à importer, avec un environnement pour votre jeton.

Description OpenAPI

Générez un client, ou suivez le dépôt pour être informé des nouveaux endpoints.

Questions sur l’API

Quelles offres incluent l’API ?

Les jetons API sont inclus dès l’offre Pro, en lecture comme en écriture. Sur toutes les offres, gratuite comprise, vous pouvez essayer l’API dans une sandbox gratuite avec des jetons de test, et connecter Claude ou ChatGPT via le serveur MCP.

Puis-je essayer sans toucher à ma vraie infrastructure ?

Oui. Créez une sandbox dans Mon compte → Développeur. Elle contient des zones DNS, moniteurs, domaines et un serveur d’exemple. L’écriture y fonctionne, et rien n’atteint jamais un fournisseur ni Internet.

L’écriture fonctionne-t-elle tout de suite ?

Pendant le déploiement de l’API, l’écriture est activée organisation par organisation. La lecture fonctionne tout de suite ; demandez-nous et nous activons votre organisation. Dans votre sandbox, l’écriture fonctionne déjà.

Quelles sont les limites de débit ?

Chaque jeton a droit à 300 requêtes et 60 modifications par minute, et 1 000 modifications par heure. Chaque réponse indique ce qu’il reste. Au-delà, l’API répond 429 avec le nombre de secondes à attendre.

Que ne peut jamais faire un jeton ?

Tout ce qui achète, détruit ou change qui a accès : enregistrer ou renouveler des domaines, commander ou supprimer des serveurs, supprimer des zones, changer les serveurs de noms, les membres, les identifiants des fournisseurs et votre propre compte. Cela reste réservé à une personne connectée à l’app.

Comment vérifier qu’un webhook vient bien d’InfraNest ?

Chaque requête porte X-InfraNest-Signature-V2 : un HMAC-SHA256 de l’horodatage et du corps, calculé avec le secret de votre endpoint. Recalculez-le, comparez les deux et refusez un horodatage décalé de plus de cinq minutes. La documentation fournit du code prêt à l’emploi.

L’API peut-elle changer sans prévenir ?

De nouveaux champs et endpoints sont ajoutés sans préavis. Supprimer ou renommer quoi que ce soit est annoncé six mois à l’avance dans le changelog, que vous pouvez suivre en RSS. Les codes d’erreur ne changent jamais.

Jeton API ou OAuth ?

Un jeton API sert à vos propres scripts, CI et outils. OAuth sert à une application que d’autres personnes connectent à leur propre compte InfraNest. Les deux utilisent les mêmes portées et limites.

Votre premier appel en cinq minutes

La documentation vous mène de zéro jeton à une requête qui fonctionne, avec une sandbox gratuite pour essayer.

Ouvrir la documentation développeur Commencer gratuitement

Sandbox gratuite · Jetons API dès Pro