API REST, provider Terraform, CLI Go, et SDKs en Go, Python, JS, Ruby. Tout ce qui est dans le dashboard est aussi scriptable. Webhooks pour l'automatisation de flotte.
FranceVPS expose une API REST propre, un provider Terraform de premier ordre, et un CLI écrit en Go. Tout ce que vous faites dans le dashboard est scriptable. Tout ce qui est scriptable peut aller dans un pipeline CI. Nous ne verrouillons pas les fonctionnalités derrière des paliers "enterprise" — l'API est identique pour un Starter à 2,48 € comme pour un cluster dédié à 4 000 €/mois.
Versionnée en /v6/, JSON en entrée/sortie, OAuth 2.0 avec PKCE pour les flux CLI, simples bearer tokens côté serveur. Rate-limit à 1000 requêtes/minute par token, avec burst autorisé. Pagination par cursor. Webhooks sur chaque opération qui change l'état.
# Provisionner un Cloud VPS
curl -X POST https://api.fra-vps.com/v6/instances \
-H "Authorization: Bearer $FRANCEVPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"plan": "cloud-hp-2",
"image": "ubuntu-24.04",
"region": "fr-par-1",
"ssh_keys": ["ssh-key-abc123"],
"hostname": "web-01"
}'Publié sous francevps/francevps sur le Terraform Registry. Les ressources couvrent les instances VPS, clés SSH, snapshots, IPs flottantes, réseaux privés, load balancers, et records DNS. Les data sources permettent de chercher images, plans et régions dynamiquement.
Binary unique, écrit en Go, distribué via Homebrew, apt, dnf, et binary statique sur les releases GitHub. Authentification via francevps auth login (OAuth basé navigateur) ou token. Les commandes du CLI miroirent exactement l'API.
Abonnez-vous aux événements de cycle de vie : instance.created, instance.started, instance.stopped, instance.destroyed, snapshot.created, billing.invoice.paid, et une douzaine d'autres. Webhooks signés en HMAC-SHA256, réessayés en backoff exponentiel jusqu'à 24 h.
SDKs first-party en Go, Python, JavaScript/TypeScript, et Ruby. SDKs communautaires (que nous référençons mais ne maintenons pas) pour PHP, Rust, et Elixir. Tous les SDKs sont auto-générés depuis notre spec OpenAPI.
Notre provider Terraform, tous nos SDKs, et les templates de déploiement marketplace sont open source sous MIT ou Apache 2.0. Nous acceptons les PRs. Voir github.com/francevps.