{"service":"cumulus","uri-patterns":[["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/clef","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/nom","Récupère le fichier identifié par clef, ou nommé nom et contenu dans le répertoire \/chemin\/arbitraire (déclenche son téléchargement)","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/dossier","Récupère le contenu du dossier identifié par le chemin, càd ses sous-dossiers et ses fichiers"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-name\/compte rendu","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-name\/compte rendu?LIKE (par défaut)","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-name\/compte rendu?STRICT","Renvoie une liste de fichiers (les clefs et les attributs) correspondant au nom ou à la \/ aux portion(s) de nom fournie(s), quels que soient leurs emplacements"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-path\/mon\/super\/chemin","Renvoie une liste de fichiers (les clefs et les attributs) présents dans un dossier dont le chemin est \/mon\/super\/chemin","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-path\/mon\/super\/chemin?R","Renvoie une liste de fichiers (les clefs et les attributs) présents dans un dossier dont le chemin est \/mon\/super\/chemin ou un sous-dossier de celui-ci"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-keywords\/foo","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-keywords\/foo,bar,couscous","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-keywords\/foo,bar,couscous?AND (par défaut)","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-keywords\/foo,bar,couscous?OR","Renvoie une liste de fichiers (les clefs et les attributs) correspondant à un ou plusieurs mots-clefs"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-user\/jean-bernard@tela-botanica.org","Renvoie une liste de fichiers (les clefs et les attributs) appartenant à l'utilisateur jean-bernard@tela-botanica.org"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-group\/botanique-à-bort-les-orgues","Renvoie une liste de fichiers (les clefs et les attributs) appartenant au groupe \"botanique-à-bort-les-orgues\""],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-mimetype\/image\/png","Renvoie une liste de fichiers (les clefs et les attributs) ayant un type MIME \"image\/png\""],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-date\/2015-02-04","Renvoie une liste de fichiers (les clefs et les attributs) datant exactement du 04\/02\/2015","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-date\/2015-02-04?BEFORE","Renvoie une liste de fichiers (les clefs et les attributs) datant d'avant le 04\/02\/2015 (exclu)","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-date\/2015-02-04?AFTER","Renvoie une liste de fichiers (les clefs et les attributs) datant d'après 04\/02\/2015 (exclu)","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/by-date\/2014-07-13\/2015-02-04","Renvoie une liste de fichiers (les clefs et les attributs) datant d'entre le 13\/07\/2014 et le 04\/02\/2015"],["GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/search\/foo,bar","Recherche floue parmi les noms et les mots-clefs","GET https:\/\/api.tela-botanica.org\/service:cumulus:doc\/api\/search?keywords=foo,bar&user=jean-bernard@tela-botanica.org&date=...","Recherche avancée"],["OPTIONS https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/clef","Récupère les attributs du fichier clef contenu dans le répertoire \/chemin\/arbitraire, mais pas le contenu du fichier"],["DELETE https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/clef","Supprime le fichier clef contenu dans le répertoire \/chemin\/arbitraire"],["Avec un envoi de formulaire avec fichier - Content-type: multipart\/form-data","POST https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/clef",{"file":"le fichier (input type=\"file\")","keywords":"les mots-clefs à associer (Array)","groups":"les groupes auxquels associer le fichier (Array)","permissions":"les permissions","license":"la licence du fichier","meta":"portion de JSON libre"},"Ajoute au stockage le fichier uploadé; lui donne la clef clef; lui donne comme répertoire parent \/chemin\/arbitraire; les autres paramètres sont explicites.","Seront détectés : mimetype, size, name, user (si un jeton d'authentification est présent).","Si file est une URL, le fichier sera un pointeur sur cette URL.","creation_date et last_modification_date seront définis à la date courante. Renvoie les attributs."],["Avec le contenu du fichier dans le paramètre \"file\" - Content-type: application\/json","POST https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/clef",{"file":"le contenu du fichier envoyé, encodé en  Base64","keywords":"les mots-clefs à associer (Array)","groups":"les groupes auxquels associer le fichier (Array)","permissions":"les permissions","license":"la licence du fichier","meta":"portion de JSON libre"},"Ajoute au stockage le fichier présent dans file; lui donne la clef clef; lui donne comme répertoire parent \/chemin\/arbitraire; les autres paramètres sont explicites.","Seront détectés : mimetype, size, name, user (si un jeton d'authentification est présent).","Si file est une URL, le fichier sera un pointeur sur cette URL.","creation_date et last_modification_date seront définis à la date courante. Renvoie les attributs."],["Avec un envoi en flux - contenu du fichier dans le body de la requête - Content-type : application\/octet-stream ou application\/x-www-form-urlencoded","POST https:\/\/api.tela-botanica.org\/service:cumulus:doc\/chemin\/arbitraire\/clef","Ajoute au stockage le fichier contenu dans le corps de la requête; lui donne la clef clef; lui donne comme répertoire parent \/chemin\/arbitraire. Renvoie les attributs."]],"output format":{"fkey":"clef","name":"nom du fichier","path":"chemin du fichier (dossier parent)","mimetype":"type MIME du fichier","size":"taille du fichier en octets","owner":"propriétaire du fichier","groups":"groupes (Array)","permissions":"permissions du fichier","keywords":"mots-clefs associés (Array)","license":"licence du fichier","meta":"portion de JSON libre","creation_date":"date de création","last_modification_date":"date de dernière modification","href":"lien de téléchargement du fichier"},"permissions":["Les permissions sont gérées par les trois champs owner, permissions, groups","Si owner est NULL ou vide, ou si permissions est NULL ou vide, le fichier est public (lecture et écriture pour tous).","Si l'utilisateur est propriétaire du fichier, il a tous les droits.","Sinon, les permissions sont inspirées d'UNIX et tiennent sur deux caractères. Le premier concerne les groupes, et le second les 'autres'. Le caractère peut être 'r' (lecture), 'w' (lecture et écriture - inclut la suppression), ou '-' (aucun droit).",{"r-":"lecture pour les membres d'un des groupes, aucun droit pour les autres","wr":"lecture et écriture pour les membres d'un des groupes, lecture pour les autres","ww":"lecture et écriture pour tous (équivalent à NULL ou vide)","--":"seul le propriétaire a les droits"}]}