API REST v1

Documentation API VPS1Euro

API client pour gerer vos VPS, vos IP, WebGate et le proxy SSH IPv4. Toutes les references serveur utilisent vps_name (format VPS-XXXXX, prefixe accepte en minuscule et majuscule).

Base URL /v1

Format JSON (UTF-8)

Auth Bearer API Key

Quick Start

Exemple minimal pour verifier l'acces API:

curl -X GET https://api.vps1euro.fr/v1 \
  -H "Authorization: Bearer YOUR_API_KEY"

Reponse attendue:

{
  "success": true,
  "data": {
    "version": "v1",
    "service": "VPS1Euro API",
    "timestamp": "2026-03-12T11:24:58+00:00",
    "permissions": ["vps.read", "ip.read"]
  }
}

Catalogue des endpoints

Groupe	Route principale	Description
Systeme	`GET /v1`, `GET /v1/me`	Etat API et informations compte API.
VPS	`/v1/vps/{vps_name}`	Lecture, actions, monitoring, snapshots.
IP Addresses	`/v1/services/ip-addresses/*`	Liste, attache et detache IPv4/IPv6.
WebGate	`/v1/services/webgate/*`	Domaines, ports dedies, load balancing.
Proxy SSH IPv4	`/v1/services/proxy-ssh-ipv4/*`	Lecture mapping et mise a jour port SSH VPS.

Exemples rapides

Action reboot VPS

curl -X POST https://api.vps1euro.fr/v1/vps/VPS-0000/action \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"reboot"}'

Attacher IPv4

curl -X POST https://api.vps1euro.fr/v1/services/ip-addresses/ipv4/15/attach \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vps_name":"VPS-0000"}'