Aller au contenu

Pilotage

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

GET /admin/courriel Owner et Admin

L’état du courrier sortant : SMTP configuré ou non (hôte seulement, jamais le mot de passe), expéditeur, et les cinquante derniers envois DE L’ENTREPRISE, lus dans le journal des courriels, avec leur erreur.

Réponse{ configure, hote, from, essais: EssaiCourriel[] }
POST /admin/courriel/test Owner et Admin

Envoie un courriel de test à l’adresse de l’administrateur qui le demande, et rend le verdict avec l’erreur brute du relais.

Réponse{ ok, erreur, to }
NoteL’essai entre au journal des courriels (Log mail), ligne FAILED comprise quand SMTP n’est pas configuré.
GET /admin/mails Owner et Admin

Le journal des courriels (Log mail) : tout courriel transactionnel parti de l’entreprise — membres, contacts des clients, adresses saisies — avec son verdict, du plus récent au plus ancien.

Requêtecursor, limit (1-100, défaut 50), kind (une sorte d’EMAIL_KINDS), status (PENDING, ACCEPTED, REJECTED, FAILED), recipientKind (MEMBER, CONTACT, ADDRESS), q (adresse ou sujet, sans tenir compte de la casse), recipient (l’adresse d’une personne : destinataire, copie ou copie cachée)
RéponseEmailLogPageDto
Note« ACCEPTED » veut dire accepté par le RELAIS, jamais reçu : Nexus ne lit pas les retours asynchrones (bounces), seul un refus immédiat est connu (REJECTED). « openedAt » vient d’un pixel de suivi : indicatif (images bloquées ou préchargées). Le corps du message ne sort qu’au détail.
GET /admin/mails/:id Owner et Admin

Un courriel du journal, avec son HTML et sa version texte tels qu’ils sont partis, et la réponse du relais.

RéponseEmailLogDetailDto
NoteLe HTML stocké est celui du message, SANS le pixel d’ouverture ; les jetons à usage unique (invitation, mot de passe, page publique d’un rapport) y sont masqués (••••••) — relire le journal ne permet jamais d’accepter une invitation. Un identifiant d’une autre entreprise est un 404.
GET /admin/adoption Owner et Admin

Adoption de Nexus : sessions par projet et par semaine, membres inactifs.

Requêtefrom, to (ISO 8601 ; défaut 8 semaines)
RéponseAdoptionDto
GET /admin/clients-usage Owner et Admin

Ce qu’un client a coûté sur la période : ses projets, qui y a réellement travaillé, ses tokens, ses demandes. Réservé aux administrateurs.

Requêtefrom, to (un an au plus)
RéponseClientUsageRowDto[]
GET /admin/projects-usage Owner et Admin

Ce que chaque projet a consommé sur la période : sessions, prompts, tokens, coût théorique.

Requêtefrom, to
RéponseProjectUsageRowDto[]
GET /admin/projects-usage/:id Owner et Admin

Le détail d’un projet : chaque session, son coût, ses prompts.

Requêtefrom, to
RéponseProjectUsageDetailDto