pour utiliser, importer et exporter des données depuis et vers votre instance de Pod, vous avez deux possibilités : via un navigateur ou en ligne de commande.
1) Navigateur
Via votre navigateur, il vous suffit de vous rendre sur la page Rest de votre pod : http(s)://pod.univ.fr/rest et de renseigner le compte root de votre instance.
Vous aurez donc accès aux données au format JSON de votre instance et pourrez en poster de nouvelles.
N'hésitez pas à explorer cette interface pour y découvrir toutes les possibilités. Je vous conseille de restreindre l'accès à "/rest" de votre instance via votre configuration nginx.
2) Terminal
Pour gérer les données de votre instance de Pod en ligne de commande, voici les différentes étapes à suivre :
- Dans l'administration, il faut créer un jeton d'authentification : http(s)://pod.univ.fr/admin/authtoken/token/
Attention, le jeton aura les mêmes accès que l'utilisateur sélectionné pour le créer.
Il vous suffit ensuite d’utiliser ce jeton dans vos requêtes Curl.
Par exemple, cette requête permet de récupérer les utilisateurs :
curl -H "Content-Type: application/json" -H 'Authorization: Token XXXXXXXXXXX71922e47ed412eabcbd241XXXXXXX' -X GET -d '{}' http(s)://pod.univ.fr/rest/users/Pour savoir comment créer vos requêtes, n'hésitez pas à utiliser l'interface web via votre navigateur, vous aurez la liste des objets modifiables et des exemples de requêtes.
Autre exemple, la commande suivante permet de créer un type intitulé "test :
curl -H "Content-Type: application/json" -H 'Authorization: Token XXXXXXXXXXX71922e47ed412eabcbd241XXXXXXX' -X POST -d '{
"title": "test"
}' http(s)://pod.univ.fr/rest/types/
L’exécution de cette commande renvoie le type créé :
{"id":13,"url":"http(s)://pod.univ.fr/rest/types/13/","title":"test","description":"-- désolé, aucune traduction fournie --","icon":null}
Enfin, on peut modifier un élément présent. Par exemple, on peut changer le type créé ci-dessus.
La commande suivante change le titre du type dont l'identifiant est 13
curl -H "Content-Type: application/json" -H 'Authorization: Token XXXXXXXXXXX71922e47ed412eabcbd241XXXXXXX' -X PATCH -d '{
"title": "test new"
}' http(s)://pod.univ.fr/rest/types/13/
Cette commande renvoie les mêmes informations que lors de la création.
Enfin, il est également possible de poster des vidéos en ligne de commande. Voici un exemple :
curl -H "Content-Type: multipart/form-data" \
-H 'Authorization: Token XXXXXXXXXXX71922e47ed412eabcbd241XXXXXXX' \
-F "owner=1" \
-F "type=1" \
-F "title=ma video" \
-F "video=@/Users/test/video.mp4" \
http(s)://pod.univ.fr/rest/videos/