Sur cette page
Velnex expose une API de gestion sur https://votre-domaine/api/manage/v1, utilisée par l’application de gestion Velnex et utilisable par vos propres scripts.
Authentification
On se connecte avec un compte de l’équipe : l’API renvoie un jeton (préfixe vxm_) valable 30 jours, prolongé à chaque utilisation.
curl -s https://billing.mon-hebergeur.fr/api/manage/v1/login \
-H "Accept: application/json" \
-d [email protected] -d password='••••••••' -d device="Mon script"
Si le compte a la double authentification, ajoutez -d code=123456. Envoyez ensuite le jeton à chaque requête :
curl -s https://billing.mon-hebergeur.fr/api/manage/v1/me \
-H "Accept: application/json" -H "Authorization: Bearer vxm_…"
POST /logout supprime le jeton. Il n’y a pas de portée à régler : l’API applique les permissions du rôle du membre. Créez donc un membre dédié, avec un rôle limité à ce dont votre script a besoin.
Ce qu’on peut faire
| Domaine | Exemples |
|---|---|
| Compte | me, dashboard, account |
| Clients | liste, création, modification, réinitialisation du mot de passe, export, demandes RGPD |
| Factures | liste, détail, PDF, marquer payée, créer, annuler, avoirs |
| Services | liste, création, création chez le fournisseur, suspension, réactivation, résiliation |
| Tickets | liste, détail, réponse, pièces jointes |
| Catalogue et contenu | produits, FAQ, base de connaissances, pages, menus, thèmes |
| Administration | équipe, rôles, paramètres, passerelles, serveurs (et test de connexion), extensions |
Limites
- 240 requêtes par minute par membre, 10 tentatives de connexion par minute.
- Si la 2FA est obligatoire et que le membre ne l’a pas activée, l’API refuse l’accès.
- Quand la licence n’est pas valide, seules la connexion, la déconnexion et
merépondent. - Velnex n’envoie pas de webhooks sortants : interrogez l’API à intervalles réguliers.
Cet article n’a pas résolu votre problème ?
Ouvrir un ticket