API et webhooks

Une API REST pour toute votre stack

Tout ce que vous pouvez faire dans InfraNest, vous pouvez l’automatiser. Domaines, DNS, serveurs, certificats et supervision se trouvent derrière un seul endpoint et un seul jeton — avec des webhooks signés et des endpoints d’ingestion pour les outils que vous utilisez déjà.

Explorer la doc de l’API →Obtenir une clé API

Offre gratuite · Sans carte bancaire · Jetons à portée limitée en quelques secondes

api.infranest.app

200 OK

# Lister les enregistrements DNS
curl https://api.infranest.app/v1/dns/records \
  -H "Authorization: Bearer inf_live_•••"

{
  "data": [
    { "type": "A", "name": "@", "synced": true }
  ]
}

Une seule API pour tout ce que fait InfraNest

Chaque domaine produit est disponible via la même API REST — du JSON propre, un seul jeton, et les mêmes actions que dans le tableau de bord.

Domaines & contacts

Enregistrez, transférez, renouvelez et lisez domaines, contacts et expiration chez tous les registrars.

GET /v1/domains

DNS

Créez, mettez à jour et synchronisez zones, enregistrements et modèles — avec détection d’écarts.

POST /v1/dns/zones/{id}/records

Serveurs & cloud

Provisionnez, redémarrez, prenez des snapshots et lisez les métriques des serveurs, volumes et pare-feux.

POST /v1/servers/{id}/actions

Certificats

Lisez votre inventaire de certificats, expiration, posture et failles de couverture.

GET /v1/certificates

Surveillance

Gérez les vérifications, lisez incidents et maintenance, et pilotez les pages de statut.

GET /v1/monitors

IP dynamique

Gérez les sources d’IP dynamique et les enregistrements et règles de pare-feu qu’elles pilotent.

GET /v1/dynamic-ips

Des jetons avec exactement l’accès qu’il vous faut

Donnez à chaque jeton API uniquement les permissions dont il a besoin — lecture ou écriture, par domaine — avec une expiration facultative. Voyez quand un jeton a été utilisé pour la dernière fois, et révoquez-le à tout moment.

Accès en lecture ou écriture par domaine — ou lecture seule et accès complet
Expiration facultative ; le jeton est affiché une fois, puis seul un indice est conservé
Des limites de débit en usage équitable gardent tout stable

Nouveau jeton API · ci-deploy-botCréer

dns.write

domains.read

monitoring.read

cloud.write

inf_live_9f2c•••••••••••••••• · expire dans 90 j

Des webhooks pour les événements qui comptent pour vous

Pointez une URL vers les événements de votre choix et InfraNest y poste quand ils se produisent — chaque message signé pour que vous puissiez vérifier qu’il vient vraiment de nous. Les livraisons sont journalisées, et les échecs sont réessayés automatiquement.

domain.expiringdomain.status_changeddns.records_changedserver.status_changedmonitor.alertwatched_domain.dropping_soonwatched_domain.availablewatched_domain.registered

POSTyour-app.com/webhooks

X-InfraNest-Event: domain.expiring
X-InfraNest-Timestamp: 1720353600
X-InfraNest-Signature: sha256=a1b2c3…

{
  "event": "domain.expiring",
  "data": { "domain": "example.com", "expires_at": "2026-08-01" }
}

Des endpoints d’ingestion pour les outils que vous utilisez déjà

Des endpoints simples et protégés par jeton que votre infrastructure appelle vers InfraNest — sans connexion, chacun avec son propre jeton à portée limitée.

Mises à jour d’IP dynamique

Votre routeur ou ddclient signale une IP changeante, et vos enregistrements DNS et règles de pare-feu se mettent à jour automatiquement.

Heartbeats

Une tâche cron pingue une URL unique selon un horaire — un ping manquant déclenche une alerte.

Hooks de déploiement

Déclenchez un déploiement depuis votre pipeline CI/CD avec un simple webhook entrant — journalisé avec qui l’a fait.

Sondes distantes

Exécutez des vérifications de surveillance depuis vos propres emplacements et renvoyez les résultats en toute sécurité.

Agent serveur

Un agent léger sur vos serveurs pousse des données — comme les certificats d’un serveur vers votre inventaire.

Sûr par conception

Chaque jeton n’obtient que l’accès que vous choisissez, avec expiration facultative

Des webhooks signés que vous pouvez vérifier — pour savoir qu’ils viennent d’InfraNest

Livraison sûre, et chaque secret stocké chiffré

Des limites de débit en usage équitable et un journal d’audit complet de chaque action

FAQ API & webhooks

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

Chaque webhook est signé avec un secret que vous seul et InfraNest partagez. Chaque requête porte un en-tête de signature — recalculez-le à partir du corps de la requête et de votre secret, et vérifiez qu’ils correspondent. Si c’est le cas, le message vient bien d’InfraNest et n’a pas été modifié en chemin. Des exemples pas à pas sont dans la doc.

Quels événements les webhooks peuvent-ils envoyer ?

Un domaine qui expire ou change de statut, des enregistrements DNS qui changent, un serveur qui monte ou tombe, une alerte de surveillance, et le cycle de vie du drop-catch (un domaine surveillé qui devient disponible ou est enregistré). Vous choisissez exactement quels événements chaque endpoint reçoit.

Faut-il une offre payante pour utiliser l’API ?

Vous pouvez démarrer sur l’offre gratuite. L’accès à l’API et le nombre d’endpoints webhook évoluent avec votre offre, donc l’automatisation plus intensive vit sur les offres payantes.

Y a-t-il une limite de débit ?

Oui — des limites en usage équitable protègent la plateforme et évoluent avec votre offre. Si vous en atteignez une, l’API répond par un message clair « réessayez sous peu », pour que votre script puisse temporiser et réessayer.

Construire sur InfraNest

La référence complète des endpoints, l'authentification et des exemples se trouvent dans la documentation API interactive.

Ouvrir la doc API Base de connaissances

Offre gratuite · Sans carte bancaire