Docs est le traitement de texte collaboratif (type Google Docs) : arborescence de documents, édition collaborative temps réel (Yjs), commentaires, partage par lien, IA.
- Base URL — prod :
https://docs.api.puwapi.com· dev :http://localhost:6100 - Auth : JWT + gating
docs(Business+). Partage par lien = anonyme.
Arborescence (nodes)¶
Base : /api/docs/nodes — dossiers et documents.
| Méthode | Route | Rôle |
|---|---|---|
| GET | /api/docs/nodes | Lister l'arbre |
| GET | /api/docs/nodes/trash | Corbeille |
| GET | /api/docs/nodes/recent | Récents |
| GET | /api/docs/nodes/{id}/breadcrumb | Fil d'Ariane |
| POST | /api/docs/nodes | Créer un dossier / document |
| PATCH | /api/docs/nodes/{id} | Renommer / déplacer |
| DELETE | /api/docs/nodes/{id} | Mettre à la corbeille |
| POST | /api/docs/nodes/{id}/restore | Restaurer |
Édition d'un document¶
Base : /api/docs/documents
| Méthode | Route | Rôle |
|---|---|---|
| GET | /api/docs/documents/{id}/session | Session d'édition collaborative |
| PUT | /api/docs/documents/{id}/snapshot | Sauvegarder un instantané |
L'édition en temps réel repose sur Yjs (CRDT) ; le serveur conserve des instantanés.
Commentaires¶
| Méthode | Route |
|---|---|
| GET/POST | /api/docs/documents/{id}/comments |
| POST | /api/docs/documents/{id}/comments/{commentId}/resolve |
| DELETE | /api/docs/documents/{id}/comments/{commentId} |
Partage¶
Base : /api/docs (routes de partage [AllowAnonymous] pour l'accès par lien)
| Méthode | Route | Rôle |
|---|---|---|
| GET/POST | /api/docs/nodes/{id}/permissions | Permissions par utilisateur |
| DELETE | /api/docs/nodes/{id}/permissions/{permId} | Retirer une permission |
| GET/POST | /api/docs/nodes/{id}/share-links | Liens de partage |
| DELETE | /api/docs/share-links/{linkId} | Révoquer un lien |
| GET | /api/docs/{token} | Ouvrir un document via un lien de partage |
IA¶
| Méthode | Route | Rôle |
|---|---|---|
| GET | /api/docs/documents/ai/status | État de l'IA |
| POST | /api/docs/documents/{id}/ai/generate | Génération (branchée sur le module IA) |
Le bouton « Résumé IA » du Hub passe par la feature doc_summary du module IA.
Route interne (M2M)¶
/api/docs/internal/{provision,rename,delete} — provision de documents depuis un autre
contexte. X-Internal-Secret.