Développeurs

Bâtir sur VeloNodes

Une API REST et des SDK typés pour chaque service — serveurs, Postgres, courriel, IA et flux. Voici tout ce qu'il faut pour votre premier appel.

Démarrage rapide

Installez le SDK, définissez votre clé et provisionnez votre premier nœud en trois appels.

install 
npm install @velonodes/sdk   # or: pip install velonodes
quickstart.ts 
import { VeloNodes } from "@velonodes/sdk";

const vn = new VeloNodes(process.env.VN_KEY);

// 1. provision a node
const node = await vn.vps.create({ region: "yul1", size: "velocity-4" });

// 2. send a welcome email
await vn.email.send({ to: "[email protected]", template: "welcome" });

// 3. let AI watch it
await vn.ai.watch(node.id);

Authentification

Toutes les requêtes utilisent une clé d'API Bearer. Créez des clés limitées — avec un plafond de dépenses par clé — depuis le tableau de bord ou l'API.

auth 
# every request is authenticated with a Bearer key
export VN_KEY="vn_live_9f2c…"

curl https://api.velonodes.org/v1/usage \
  -H "Authorization: Bearer $VN_KEY"

Référence API

URL de base https://api.velonodes.org. JSON en entrée, JSON en sortie, idempotent par conception.

POST /v1/vps Créer un nœud VPS
GET /v1/vps/:id Obtenir un nœud
POST /v1/postgres Créer une base Ledger
POST /v1/email/send Envoyer un courriel
POST /v1/ai/query Poser une question à Insight AI
POST /v1/flows/:id/run Déclencher un flux
GET /v1/usage Usage facturable courant

Régions

Passez un identifiant de région à toute ressource qui stocke ou traite des données. Les données restent dans la région choisie.

Identifiant Emplacement Résidence
yul1 Montréal, Canada Résidence des données au Canada
fra1 Francfort, Allemagne UE / RGPD
iad1 Ashburn, États-Unis Est des États-Unis

SDK

Des SDK maison, entièrement typés. Les mêmes formes dans tous les langages.

TypeScript Python Go Rust

Webhooks

Abonnez-vous aux événements de la plateforme et pilotez vos propres automatisations. Chaque charge utile est signée.

POST /your-endpoint 
{
  "event": "vps.created",
  "data": { "id": "node_yul1_9f2c", "status": "running" },
  "created": "2026-07-27T20:12:00Z"
}