Cloud est le stockage de fichiers de la plateforme : fichiers et dossiers, corbeille, favoris, partage, et un stockage objet (S3) sous-jacent. Il est inclus dès le premier palier, différencié par le quota (5 / 50 / 200 Go…), et il alimente aussi les images en ligne de Docs et Slides.
- Base URL — prod :
https://cloud.puwapi.com· dev :http://localhost:5400 - Auth : JWT. Certaines routes (upload/inline) sont anonymes mais signées.
Fichiers¶
Base : /api/cloud/files
| Méthode | Route | Rôle |
|---|---|---|
| POST | /api/cloud/files/upload-url | Obtenir une URL d'upload signée (étape 1) |
| POST | /api/cloud/files/upload-confirm | Confirmer l'upload (étape 2) |
| GET | /api/cloud/files/{id}/download-url | URL de téléchargement |
| GET | /api/cloud/files/{id}/tenant-download-url | URL de téléchargement interne |
| GET | /api/cloud/files/{id}/inline | Rendu inline (image signée ?t=, anonyme) |
| PATCH | /api/cloud/files/{id} | Renommer / déplacer métadonnées |
| DELETE | /api/cloud/files/{id} | Mettre à la corbeille |
| POST | /api/cloud/files/{id}/move | Déplacer |
| POST | /api/cloud/files/{id}/share | Partager |
| POST | /api/cloud/files/{id}/star | Favori |
| POST | /api/cloud/files/{id}/restore | Restaurer depuis la corbeille |
| POST | /api/cloud/files/bulk-delete, /bulk-move | Actions groupées |
L'upload est en deux temps : on demande une URL signée, on téléverse directement vers le stockage objet, puis on confirme.
Dossiers¶
Base : /api/cloud/folders
| Méthode | Route | Rôle |
|---|---|---|
| GET | /api/cloud/folders/contents | Contenu de la racine |
| GET | /api/cloud/folders/{id}/contents | Contenu d'un dossier |
| GET | /api/cloud/folders/{id}/breadcrumb | Fil d'Ariane |
| GET | /api/cloud/folders/search | Rechercher |
| GET | /api/cloud/folders/starred | Favoris |
| GET | /api/cloud/folders/trash | Corbeille |
| POST | /api/cloud/folders | Créer |
| PATCH | /api/cloud/folders/{id} | Renommer |
| POST | /api/cloud/folders/{id}/star, /restore | Favori / restaurer |
| DELETE | /api/cloud/folders/{id} | Supprimer |
Quota¶
GET /api/cloud/quota — quota et consommation de l'organisation.
Documents & usage interne¶
POST /api/cloud/documents— création de document (lié à la suite bureautique).POST /api/cloud/internal/usage— comptabilisation d'usage (M2M,X-Internal-Secret) : utilisé quand Docs/Slides téléversent des images comptées dans le quota.