Interactivités: documentation pour le développeur:Protocole Voter

Un article de ScriptdigitalWiki.

Jump to: navigation, search

Inscription des moteurs d'interactivités - Protocole Voter - Protocole Enquêter - Protocole Justifier


Protocole Voter

  • Pour vérifier qu'un client Flash est bien inscrit auprès du serveur, le fichier Flash doit effectuer une requête de ce type (je sépare l'URL aux fins de lisibilité).
http://example.org/www/servicesweb2/sites/interactivites/voter.php
?
mode=statusClient
&
urlClientFlash=http://www.client.com/fichier.swf

-> urlClient doit être URL encodé.


  • À chaque réponse que le fichier Flash reçoit du serveur, il devrait toujours y avoir au minimum la variable "status".
Content-type: application/x-www-form-urlencoded

status=ok
ou
status=nok


Pour envoyer un choix de vote au serveur, on utilise la même URL mais avec modification du param "mode" -> mode=insere

Si les choix de vote ne sont pas supérieurs à 2, on peut procéder ainsi.

http://example.org/www/servicesweb2/sites/interactivites/voter.php
?
mode=insere
&
urlClientFlash=http://www.client.com/fichier.swf
&
vote=1 ou vote=2


Si le nombre de choix possibles est supérieur à 2, on utilise la même URL que plus haut mais on ajoute le param "nombrequestions".

http://example.org/www/servicesweb2/sites/interactivites/voter.php
?
nombrequestions=4
&
mode=insere
&
urlClientFlash=http://www.client.com/fichier.swf
&
vote=1 ou vote=2 ou vote=3 ou vote=4

Au minimum, trois variables doivent être présentes: "status", "vote_1" et "vote_2".

Une réponse positive pourrait avoir l'air ce ceci dans le cas d'un vote à deux choix:

Content-type: application/x-www-form-urlencoded

status=ok&vote_1=60&vote_2=40

La réponse est le pourcentage des votes pour chaque question.

Dans le cas d'un vote à 4 choix, une réponse positive pourrait ressembler à ceci:

Content-type: application/x-www-form-urlencoded

status=ok&vote_1=0&vote_2=40&vote_3=5&vote_4=55

ATTENTION, l'ordre des noms des paramètres n'est pas garanti (vote_3 pourrait précéder vote_2 par exemple).