Développeurs
API HTTP
Routes principales, authentification et contrats de téléchargement.
L'API est préfixée par /api, à l'exception de la santé.
Santé
| Méthode | Route | Rôle |
|---|---|---|
GET | /health | État du service et informations non sensibles. |
Fournisseurs
| Méthode | Route | Rôle |
|---|---|---|
GET | /api/settings/credentials | Métadonnées masquées des identifiants. |
POST | /api/settings/credentials | Enregistrer clé et endpoint par fournisseur. |
POST | /api/settings/test-connection | Tester la connexion. |
POST | /api/settings/models | Récupérer les modèles disponibles. |
POST | /api/settings/test-translation | Traduire un extrait. |
POST | /api/settings/sandbox-extract | Extraire un passage d'un document temporaire. |
Projets
| Méthode | Route | Rôle |
|---|---|---|
POST | /api/jobs/upload | Importer et préparer un projet. |
GET | /api/jobs | Lister les projets. |
GET | /api/jobs/{id} | Lire un projet. |
GET | /api/jobs/{id}/segments | Lire ses segments. |
POST | /api/jobs/{id}/start | Démarrer ou reprendre. |
POST | /api/jobs/{id}/pause | Mettre en pause. |
POST | /api/jobs/{id}/retry | Réinitialiser les échecs. |
POST | /api/jobs/{id}/update-config | Modifier une configuration autorisée. |
GET | /api/jobs/{id}/download | Reconstruire et télécharger. |
DELETE | /api/jobs/{id} | Supprimer projet et fichiers dédiés. |
Glossaires et événements
GET, POST et DELETE sous /api/glossaries, ainsi que GET /api/events pour le flux SSE.
Authentification
Lorsque APP_SECRET est défini, toutes les routes du routeur exigent le secret. Les requêtes d'écriture provenant d'un navigateur passent aussi le contrôle d'origine.
Téléchargement
La réponse porte Cache-Control: no-store, X-Content-Type-Options: nosniff et X-TraDoc-Export: partial|final. Le type MIME suit l'extension reconstruite.