Gérer vos espaces
Tout ce que vous faites dans votre dashboard, depuis votre propre backend.
Avec la même clé, votre backend atteint chaque page de votre dashboard : vos
espaces, leur serveur, le réseau, les sauvegardes, les factures et les tickets de
support. Chaque appel ne porte que sur votre compte ; l’espace d’un autre compte
répond 404.
Ces appels se trouvent à côté de /v1, sous la même URL de base,
https://dash.geta.team/api. Une réponse réussie porte "success": true ; un refus
de l’appel lui-même est { "success": false, "error": "un message lisible" }, tandis
qu’un refus du contrôle de la clé garde son code (Erreurs).
curl https://dash.geta.team/api/saas-byok/instances \
-H "Authorization: Bearer gat_sk_..."Une clé en lecture seule fait les appels GET ; tous les autres demandent une clé
en lecture et écriture. Champs, réponses et erreurs de chaque appel : la
référence interactive.
Espaces
| Appel | Ce qu’il fait |
|---|---|
GET /saas-byok/instances | Vos espaces, puis ceux supprimés que vous pouvez encore restaurer |
GET /saas-byok/instances/{id}/details | Un espace |
POST /saas-byok/instances/{id}/credentials | Son adresse, l’email administrateur et le mot de passe |
GET /saas-byok/pricing | Formules et prix |
PUT /saas-byok/instances/{id}/plan | Changer de formule, { "employees": 3 } : à la hausse tout de suite (au prorata), à la baisse au prochain renouvellement |
POST /saas-byok/instances/{id}/cancel | Résilier l’abonnement à la fin de la période payée |
POST /saas-byok/instances/{id}/resume | Le garder finalement |
DELETE /saas-byok/instances/{id} | Supprimer l’espace |
Serveur
| Appel | Ce qu’il fait |
|---|---|
POST /saas-byok/instances/{id}/restart | Redémarrer l’application (rapide, sans risque) |
POST /saas-byok/instances/{id}/update | Installer la dernière version, puis redémarrer |
POST /saas-byok/instances/{id}/reset | Réinitialiser le serveur |
POST /saas-byok/instances/{id}/power-off | Éteindre (toujours facturé) |
POST /saas-byok/instances/{id}/power-on | Allumer |
POST /saas-byok/instances/{id}/redeploy | Redemander le serveur, pour un espace en erreur |
Réseau et SSH
| Appel | Ce qu’il fait |
|---|---|
GET, POST /saas-byok/instances/{id}/firewall | Lire, ou remplacer, les règles du pare-feu |
POST /saas-byok/instances/{id}/firewall/enable, /disable | Activer ou désactiver le pare-feu |
GET, POST /saas-byok/instances/{id}/domains | Lister, ou ajouter, des domaines personnalisés |
POST /saas-byok/instances/{id}/domains/remove | Retirer un domaine personnalisé |
GET, POST /saas-byok/instances/{id}/ptr | Lire, ou définir, le DNS inverse |
GET, POST /saas-byok/instances/{id}/ssh-keys | Lister, ou ajouter, des clés SSH |
DELETE /saas-byok/instances/{id}/ssh-keys/{name} | Retirer une clé SSH |
Sauvegardes
| Appel | Ce qu’il fait |
|---|---|
GET /saas-byok/instances/{id}/backups | Les sauvegardes quotidiennes, de la plus récente à la plus ancienne |
POST /saas-byok/instances/{id}/backups | Sauvegarder maintenant |
POST /saas-byok/instances/{id}/backups/restore | En restaurer une (remplace les données actuelles) |
Facturation et support
| Appel | Ce qu’il fait |
|---|---|
GET /saas/invoices | Vos factures, avec leur PDF |
GET /saas/upcoming-invoices | Ce que chaque espace paiera à son renouvellement |
GET, POST /saas/support/tickets | Vos tickets, ou en ouvrir un |
GET /saas/support/tickets/{ticketId} | Un ticket et ses réponses |
POST /saas/support/tickets/{ticketId}/replies | Répondre |
POST /saas/support/tickets/{ticketId}/resolve | Le clore |
Ce qui reste dans le dashboard
Pour votre sécurité, une clé n’atteint jamais : la connexion et la double
authentification, les clés API et le webhook eux-mêmes, l’email du compte et la
fermeture du compte. Ces routes répondent 403 not_available_with_api_key.