Abyss Storage
Abyss Storage est le service de stockage de fichiers d'Abyss. Il fournit aux développeurs une API simple pour uploader, télécharger, organiser et publier des fichiers depuis leurs propres Applications.
Storage est un service technique : il alimente d'autres produits Abyss (Cloud, Memories, Form, Spotlight…) et peut être utilisé directement via API ou via le package NPM @abyss-project/storage.
Ce que vous pouvez faire
- Uploader, écrire, télécharger des fichiers via des PreSignedUrl sécurisées
- Organiser les fichiers en buckets hiérarchiques
- Générer des miniatures automatiquement
- Exposer un fichier en accès public (sans authentification) pour servir des médias
- Recevoir des webhooks signés à chaque action sur vos fichiers
- Stocker des paires clé / valeur publiques via le Store
- Accéder à une collection de médias libres de droits
Démarrer
Storage n'a pas d'application dédiée — vous l'utilisez depuis votre propre Application. Pour commencer :
- Créez un Project et une Application depuis app.abyss-project.fr — voir Projects & Applications
- Activez le service Abyss Storage sur votre organisation — voir Activer les services
- Générez une API Key Application et conservez son
applicationId - Configurez le package Core ou appelez l'API en direct
- Suivez la page Gestion des fichiers
Partage et accès
Le contenu Storage est rattaché à une Application. Pour partager l'accès au-delà du créateur, utilisez les mécanismes de partage Abyss :
- Partager du contenu — utilisateur, team, organisation, projet, lien public
- Visibilité du contenu
Permissions
Sur une Application Storage, les membres d'organisation doivent disposer des permissions adéquates :
| Permission | Action |
|---|---|
STORAGE_READ | Consulter les fichiers et métadonnées |
STORAGE_FILE_READ | Lister et télécharger les fichiers |
STORAGE_FILE_PRE_SIGN_URL | Générer une URL signée |
STORAGE_FILE_UPDATE | Modifier les fichiers et leurs buckets |
STORAGE_FILE_DELETE | Supprimer des fichiers |
STORAGE_FILE_DUPLICATE | Dupliquer un fichier |
STORAGE_FILE_ARCHIVE | Archiver / désarchiver un fichier |
STORAGE_FILE_CRYPT | Chiffrer un fichier |
STORAGE_FILE_THUMBNAIL_READ / UPDATE / WRITE / DELETE | Gérer les miniatures |
STORAGE_STORE_READ / CREATE / UPDATE / DELETE | Gérer les entrées du Store |
STORAGE_WEBHOOK_READ / CREATE / UPDATE / DELETE / RESET_SECRET | Gérer les webhooks |
STORAGE_WEBHOOK_HISTORY_READ | Consulter l'historique des webhooks |