Il existe une JSP permettant de faire des tests sur le module-directory-rest. Elle est accessible par l'URL suivante :
jsp/admin/plugins/directory/modules/rest/TestDirectoryRest.jsp
Note : Pour accéder à cette JSP, il faut être authentifié dans le Back-Office. Il faut également commenter dans le fichier directory-rest.xml les filtres de façon à ce qu'il n'utilise pas la sécurité, sinon une réponse HTTP 401 sera renvoyée.
Syntaxe XML :
http://myhost/mywebapp/rest/directory/{id_directory}/records ou http://myhost/mywebapp/rest/directory/{id_directory}/records.xml
http://myhost/mywebapp/rest/directory/{id_directory}/record/{id_directory_record} ou http://myhost/mywebapp/rest/directory/{id_directory}/record/{id_directory_record}.xml
Syntaxe JSON :
http://myhost/mywebapp/rest/directory/{id_directory}/records.json
http://myhost/mywebapp/rest/directory/{id_directory}/record/{id_directory_record}.json
Pour créer/compléter une fiche, il faut faire un formulaire de type POST, ayant un enctype multipart/form-data et avoir les paramètres suivants :
Nom du paramètre | Type du paramètre | Description du paramètre |
---|---|---|
id_directory | text | Correspond à l'ID de l'annuaire (obligatoire) |
id_directory_record | text | Correspond à l'ID de la fiche (si non vide, alors il s'agit d'une complétude) |
http://myhost/mywebapps/rest/directory/record
Pour mettre à jour une fiche, il faut faire les mêmes opérations que pour la création/complétude d'une fiche à l'exceptio du fait qu'il faut que le header de la requête HTTP doit avoir la méthode PUT.
Pour supprimer une fiche, il faut avoir dans le header de la requête HTTP la méthode DELETE et avoir le paramètre suivant :
Nom du paramètre | Type du paramètre | Description du paramètre |
---|---|---|
id_directory_record | text | Correspond à l'ID de la fiche |
http://myhost/mywebapps/rest/directory/record