- Adresse
https://api.nexus-engine.eu/api/v1. Tout est en JSON, en UTF-8. Les dates sont en ISO 8601 (2026-09-15T18:00:00.000Z), les identifiants sont des chaînes opaques rendues par les listes — jamais devinés.- Erreurs
- Un objet
{ statusCode, error, message }, le message en français, prêt à afficher. Un 400 nomme le champ fautif. 401 : pas de clé valable. 403 : la clé est valable mais ce geste lui est refusé (rôle, lecture seule, route réservée). 404 : introuvable — ou d’une autre entreprise, ce qui est la même chose vu d’ici.
- Plafonds
- 300 requêtes par minute et par adresse IP sur l’API, 300 appels par minute et par clé sur le MCP, 30 révélations de secrets par heure et par membre, 25 Mo par requête. Un dépassement répond
429 avec le délai à attendre.
- Listes
- Les listes rendent tout ce que vous voyez, bornées par un paramètre
limit quand la route l’indique. Le journal d’audit se lit par curseur (nextCursor).
- Pièces jointes
- Envoyées et rendues en base64 dans le JSON (
dataBase64), avec leur nom et leur type MIME.
- Temps réel
- Deux flux SSE : celui d’un projet (messages, tâches, sessions, présence) et le flux personnel des notifications. Ils s’ouvrent avec la même clé, en
GET. - Version
- L’en-tête
x-nexus-client est facultatif : l’application de bureau y annonce sa version pour être prévenue quand elle est trop ancienne. Un client d’API n’a rien à y mettre.
- Appareil
- Les en-têtes
x-nexus-appareil (identifiant stable du poste) et x-nexus-plateforme (win32, darwin, linux) sont facultatifs eux aussi : l’application de bureau s’en sert pour que myLocalPath soit le dossier local de cette machine. Sans eux, c’est le dernier chemin écrit par n’importe quel appareil du membre.