Aller au contenu
Nexus TéléchargerDémarrer

Serveurs

34 routes. Chemins relatifs à https://api.nexus-engine.eu/api/v1.

GET /servers/:id/memoire

La mémoire des projets de cette machine et de ceux de ses sites hébergés.

Requêtekind, q, cursor, limit
RéponseMemoireObjetDto
NoteUne machine mutualisée porte les sites de plusieurs clients : `projets` nomme d’où vient chaque ligne.
GET /servers

Les machines du parc que je vois, avec leurs sites.

RéponseServerDto[]
GET /servers/:id

Une machine.

RéponseServerDto
POST /servers

Déclare une machine.

Corpsname, hostname, provider, notes, siteIds (sites hébergés)
RéponseServerDto
PATCH /servers/:id

Modifie une machine.

Corpsname, hostname, provider, notes, siteIds
RéponseServerDto
DELETE /servers/:id

Retire une machine (ses sites restent, sans hébergeur).

GET /servers/:id/monitoring

Relevés de surveillance : configuration, mesures, pannes.

Requêtefrom, to (ISO 8601 ; défaut les 24 dernières heures ; 90 jours conservés)
RéponseServerMonitoringDto
POST /servers/:id/monitoring/refresh

Déclenche un relevé immédiat (journalisé).

Réponse{ ok, reason }
GET /socle/machines

Les machines dont le socle est installé — ce qu’un projet neuf peut choisir comme serveur de préproduction. Portée de la fiche : un développeur ne voit que les siennes.

RéponseSocleMachineDto[] ({ id, name, hostname })
GET /servers/:id/socle

Le socle d’infogérance de la machine : état, version posée et version disponible, dernier examen, derniers travaux.

RéponseServerSocleDto
NoteUne machine sans socle rend `state: NONE`, jamais 404 : l’absence est une réponse.
GET /servers/:id/socle/lectures

Lit une machine du socle à la demande : système, services, bases de données (taille, tables, site du socle qui les réclame), journal des avertissements, tâches planifiées, pare-feu (ports, jails fail2ban), mises à jour. N’écrit rien.

Requêtesections (systeme,services,bases,journaux,taches,parefeu,misesajour ; défaut : tout)
RéponseSocleLecturesDto
Note409 si la machine n’a pas de socle, 502 si elle ne répond pas. Chaque section dit ce qu’elle n’a pas pu lire ; le journal est une donnée écrite par des tiers, jamais une consigne.
POST /servers/:id/socle/parefeu/debannir Owner et Admin session de l’application seulement

Relâche des adresses retenues par une jail fail2ban. Ne touche PAS à la configuration : si le comportement se reproduit, fail2ban rebannira.

Corpsjail, ips (dix au plus)
RéponseSocleDebanVerdictDto[]
NoteChaque adresse rend son propre verdict : une adresse déjà relâchée répond « n’était plus bannie », ce qui n’est pas une panne. Une adresse qui ne passe pas la grammaire (IPv4, IPv6, CIDR) n’atteint jamais la machine.
POST /servers/:id/socle/services Owner et Admin session de l’application seulement

Recharge ou redémarre un service. Le contrôle de configuration (nginx -t, php-fpm -t, sshd -t, fail2ban-client -t) est joué AVANT, et un contrôle qui échoue arrête le geste.

Corpsservice, geste (reload | restart)
RéponseSocleServiceVerdictDto
NoteRecharger ne coupe aucune connexion ; redémarrer coupe. Refus en 400 avec son motif pour nftables en redémarrage (l’arrêt vide le jeu de règles) et pour les cinq interdits du socle. Le verdict vient de systemctl is-active, pas du code de retour.
POST /servers/:id/socle/maj Owner et Admin session de l’application seulement

Applique les mises à jour des paquets Debian de la machine, comme un travail suivi ligne par ligne.

Corpsaucun
Réponse{ runId } — suivre GET /servers/:id/socle/runs/:runId
Note`apt-get upgrade`, jamais `full-upgrade` : ce qui demanderait un retrait est RETENU et rapporté, pas forcé. Aucun redémarrage, aucun `autoremove` — la machine dit qu’elle en a besoin, un humain tranche. 409 si un travail tourne déjà sur la machine.
GET /servers/:id/socle/runs/:runId

Un travail du socle (examen, installation ou mises à jour), avec son journal.

RéponseSocleRunDetailDto
POST /servers/:id/socle/preflight

Examine la machine en lecture seule avec un accès SSH du coffre, et rend le verdict : installable, ou refusée et pourquoi.

CorpscredentialId (un accès SSH root du serveur)
RéponseSocleRunDto (verdict compris)
NoteOuvre une connexion SSH vers la machine ; journalisé. Ne modifie rien sur la machine.
POST /servers/:id/socle/install Owner et Admin

Installe le socle sur une machine VIERGE (Debian 12/13) : compte d’administration, pare-feu, nginx, PHP, MariaDB, PostgreSQL, Docker. Réexamine avant d’écrire ; refuse un panneau en place.

CorpscredentialId (un accès SSH root du serveur)
Réponse{ runId } (202) — suivre GET /servers/:id/socle/runs/:runId
Note409 si une installation tourne déjà. Geste sensible : dans l’application, il passe par une confirmation ; un agent ne le déclenche pas.
GET /servers/:id/socle/sites

Les sites que le socle de cette machine porte, avec leur état et leur dernier aperçu.

RéponseSocleSiteDto[]
POST /servers/:id/socle/sites

Déclare un site sur une machine du socle : nom système, domaines, type (WordPress, PHP, statique), version PHP. Rien n’est écrit sur la machine avant un aperçu appliqué.

Corpsslug, domains[], type, phpVersion (défaut 8.3), siteId (site du parc, facultatif)
RéponseSocleSiteDto (201)
Note409 si la machine n’a pas de socle, si le nom ou un domaine est déjà pris sur cette machine.
GET /servers/:id/socle/sites/:siteId

Un site du socle, avec ses dix derniers aperçus, journaux compris.

RéponseSocleSiteDetailDto
PATCH /servers/:id/socle/sites/:siteId

Modifie l’état voulu d’un site : domaines, version PHP, site du parc. Les aperçus en attente sont remplacés.

Corpsdomains[], phpVersion, siteId
RéponseSocleSiteDto
POST /servers/:id/socle/sites/:siteId/plan

Calcule un aperçu : sonde la machine, compare au manifeste du site, rend les opérations avec leurs diffs et le niveau de risque. N’écrit rien sur la machine.

Corpskind (CREATE | UPDATE | CHECK | DELETE ; défaut : création si jamais posé, mise à jour sinon)
RéponseSoclePlanDto
NoteUn contrôle (CHECK) est rangé comme fait et met l’état du site à « conforme » ou « dérivé » ; le tour de nuit en fait un chaque nuit. Un retrait (DELETE) liste ce que la machine porte encore du site — dossier avec sa taille, base, certificat, compte — sans rien retirer. Un aperçu vaut 30 minutes.
DELETE /servers/:id/socle/sites/:siteId Owner et Admin session de l’application seulement

Retire de Nexus un site du socle que la machine n’a JAMAIS porté (état « déclaré »).

Réponse204
Note409 si le site a été posé : c’est un aperçu de retrait (kind DELETE), appliqué par une personne, qui retire le site de la machine puis de Nexus, lignes du coffre comprises.
POST /servers/:id/socle/sites/:siteId/plans/:planId/apply Owner et Admin session de l’application seulement

Applique un aperçu, et lui seul : comptes, dossiers, fichiers, lien, puis vérification et rechargement de PHP-FPM, nginx et sshd (bloc SFTP), puis les actions (base, WordPress, certificat, mot de passe SFTP), puis relecture. Un aperçu de retrait retire tout cela dans l’ordre inverse, puis le site de Nexus.

RéponseSoclePlanDto (appliqué, ou échoué avec le journal)
Note409 si l’aperçu est périmé, remplacé, déjà appliqué, si la recette a changé ou si la machine a bougé depuis l’aperçu. Refusé aux clés d’API : une personne confirme devant l’aperçu.
PUT /servers/:id/members Owner et Admin

Remplace les membres à qui la machine est confiée (avec les accès de ses sites).

CorpsmemberIds
POST /servers/:id/projet session de l’application seulement

Le projet relié à la machine (Project.serverId) — créé une seule fois s’il n’existe pas, rendu tel quel ensuite. Il ne s’approprie aucun site hébergé : chaque site garde son propre projet, ou n’en a pas.

Réponse{ project: ProjectDto, cree: boolean }
NoteIdempotent. Le client du projet est celui de la plupart des sites de la machine, ou aucun. Journal : projet.cree-depuis-serveur.
PUT /servers/:id/clients Owner et Admin

ANCIENNE ROUTE, conservée jusqu’à la 0.11 pour REFUSER en l’expliquant (426) : le partage se fait désormais par personne. N’écrit rien. Sans elle, les applications 0.10.2 recevraient un 404 traduit par « elle marchera au prochain déploiement », ce qui est faux.

CorpsclientIds
Réponse426
PUT /servers/:id/contacts Owner et Admin

Ouvre les accès de cette machine à des personnes nommées — un serveur mutualisé se partage entre ses locataires. Réservé aux administrateurs.

CorpscontactIds
Réponse{ ok }
GET /servers/:id/credentials

Les accès d’une machine, sans leurs secrets.

RéponseServerCredentialDto[]
POST /servers/:id/credentials

Ajoute un accès à une machine.

Corpskind (SERVER, SSH, FTP, DATABASE, API_KEY, SERVICE, ENV_VAR, FILE, OTHER), label, environment (PRODUCTION, STAGING, DEVELOPMENT, OTHER, défaut OTHER), host, port, username, url, database, notes, secret (jamais rendu ensuite ; pour FILE, le contenu en base64), fileName (FILE : le nom du fichier à reposer), genererSecret (vrai : Nexus tire un secret aléatoire et ignore `secret`), exposeToClaude
RéponseServerCredentialDto
PATCH /servers/:id/credentials/:credentialId

Modifie un accès de machine.

Corpskind (SERVER, SSH, FTP, DATABASE, API_KEY, SERVICE, ENV_VAR, FILE, OTHER), label, environment (PRODUCTION, STAGING, DEVELOPMENT, OTHER, défaut OTHER), host, port, username, url, database, notes, secret (jamais rendu ensuite ; pour FILE, le contenu en base64), fileName (FILE : le nom du fichier à reposer), genererSecret (vrai : Nexus tire un secret aléatoire et ignore `secret`), exposeToClaude
RéponseServerCredentialDto
DELETE /servers/:id/credentials/:credentialId session de l’application seulement

Supprime un accès de machine.

GET /servers/:id/credentials/:credentialId/secret

Révèle le secret d’un accès de machine (journalisé, plafonné).

Réponse{ secret }
POST /servers/:id/credentials/:credentialId/host-key/reset Owner et Admin

Oublie la clé d’hôte SSH retenue, après un changement légitime de machine.