Services Web de VoiceForm
VoiceCheck expose un service Web qui permet de créer un VoiceForm (essentiellement une importation de données). Ce service Web permet de créer des VoiceForms, de mettre à jour et de supprimer les VoiceForms existants sur le serveur VoiceCheck. Lorsque ce service Web est invoqué, VoiceCheck valide le système pour les opérations suivantes :
- S'il n'existe pas de nom de VoiceForm correspondant, un nouveau VoiceForm est créé.
- S'il existe un nom de VoiceForm correspondant, aucun nouveau VoiceForm n'est créé.
Un VoiceForm peut être importé avec ou sans étapes de VoiceForm. Le technicien est ainsi en mesure de créer les étapes du VoiceForm ultérieurement, à partir du serveur VoiceCheck.
Lorsque VoiceCheck reçoit ce message pour la lecture, la mise à jour et la suppression de VoiceForms, les validations suivantes sont prises en compte :
- Si le nom du VoiceForm n'existe pas dans VoiceCheck, aucun détail n'est renvoyé dans la réponse.
- Si le VoiceForm existe, le service Web peut uniquement mettre à jour le nom du VoiceForm.
- Si le VoiceForm ne fait pas référence à une autre entité dans VoiceCheck, il peut être supprimé. Dans le cas contraire, la suppression du VoiceForm n'est pas autorisée.
Créer les détails du VoiceForm
Service Web REST
WADL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform?_wadl
URL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform
Méthode : POST
Content-Type : application/json;charset=UTF-8
Corps du message : JSON comme indiqué dans le schéma WADL. Les éléments sont décrits dans le tableau des éléments d'entrée.
Réponse : en cas de succès, HTTP Status 200 avec Payload « VoiceForm enregistré ». En cas d'échec, le système renvoie une erreur. Tout code de statut HTTP autre que 200 ou 204 est considéré comme une erreur. Dans la mesure du possible, le système hôte doit renvoyer un corps pour les erreurs.
Paramètres POST
Un fichier VoicePlan contenant des paramètres valides dans le corps.
LIRE LES DÉTAILS DU VOICEFORM
SERVICE WEB REST
WADL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform?_wadl
URL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform/{voiceformname}
Méthode : GET
Content-Type : application/json;charset=UTF-8
Réponse : en cas de succès, HTTP Status 200 avec ou sans corps. En cas d'échec, le système renvoie une erreur.
METTRE À JOUR LES DÉTAILS DU VOICEFORM
WADL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform?_wadl
URL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform/update/{voiceformname}/{newvoiceformname}
Méthode : POST
Content-Type : application/json;charset=UTF-8
Réponse : en cas de succès, HTTP Status 200 avec ou sans corps. En cas d'échec, le système renvoie une erreur.
SUPPRIMER LES DÉTAILS DU VOICEFORM
WADL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform?_wadl
URL : <http ou https>://<hôte>:<port>/VoiceCheck/services/voiceform/{voiceformname}
Méthode : DELETE
Réponse : en cas de succès, HTTP Status 200 avec ou sans corps. En cas d'échec, le système renvoie une erreur.
Gérer les images
SERVICE WEB REST
WADL : <http ou https>://<hôte>:<port>/VoiceCheck/services/imageService?_wadl
URL : <http ou https>://<IPVoiceCheck>:<port>/VoiceCheck/services/imageService/<Répertoire/Nom du dossier><Répertoire/Nom du dossier>.....<nom du fichier photo avec extension>
Méthode : GET
Paramètre : chemin de l'image dans le système de fichiers avec le nom de l'image (le paramètre est envoyé dans l'URL)
Content-Type : (vide)
Réponse : en cas de succès, statut HTTP 200. Lorsque la photo est introuvable, le service génère une WebApplicationException avec le statut « HTTP Status 404 Not Found ».
Authentification de base : nom d'utilisateur et mot de passe VoiceCheck
ÉLÉMENTS D'ENTRÉE
PROPRIÉTÉ | TYPE | OBLIGATOIRE | DÉFINITION | VALIDATION |
---|---|---|---|---|
voiceformname |
Chaîne |
Oui | Nom du VoiceForm | Doit être unique dans VoiceCheck |