API pour la gestion des ressources
Les portails permettent d’héberger des fichiers sous forme de ressources, pour des documents, images, à rendre disponibles aux usagers.
Une API est disponible pour définir ces ressources.
Sur /api/assets/set/IDENTFIANT-DE-RESSOURCE, via la méthode HTTP POST; l’identifiant de la ressource est libre, il est commun d’utiliser un système à préfixe, par exemple "description-poste:345". Si l’identifiant n’est pas connu une nouvelle ressource sera créée, s’il est connu le fichier associé sera remplacé par le nouveau contenu.
Paramètre JSON, corps de la requête
Nom | Description | Obligatoire |
|---|---|---|
| Fichier à poser sur cette ressource; ce paramètre contient des sous-clés : content (contenu du fichier encodé en base64, content_type (type MIME du fichier, optionnel), filename (nom du fichier, optionnel). | Oui |
Format de retour
Une réponse JSON est retournée dont les entrées sont les suivantes
Nom | Description | Exemple |
|---|---|---|
| Succès de l’opération | 0 si ok, 1 en cas d’erreur |
| En cas de succès, l’adresse de la ressource publiée |