Système requis

Il faut disposer d'un serveur IntraMessenger installé et configuré (sur le réseau local ou sur internet).

Syntaxe et conventions d'écritures

Le script serveur qui sera appelé sera celui-ci : /distant/actions.php

Si l'adresse (url) de votre serveur IM est http://votre-serveur/im/
Les requêtes se feront sous cette forme :
http://votre-serveur/im/distant/actions.php?parametre1=valeur1¶metre2=valeur2¶metre3=valeur3&

Pour faciliter la lecture, les url seront indiquées (raccourcies) aux seuls paramètres, comme ceci :
?parametre1=valeur1¶metre2=valeur2¶metre3=valeur3&

Nota : le premier passage de paramètre est précédé d'un point d'interrogation, les suivants sont séparés du caractère esperluette (appelé "et commercial").
Les paramètres sont systématiquement écrits en minuscules.
Les adresses (url) ne contiennent aucun espace.

Si des textes sont envoyés, ils sont alors encodés au format base 64.
Ce format permet d'assurer l'intégrité des textes envoyés en paramètres (les espaces étant interdits, on contourne ces problèmes).

Valeurs renvoyées par le serveur

>F00#valeur1#valeur2#valeur3#
Les 4 premiers caractères ( >F00 ) indique le numéro de la fonction renvoyée (voir /doc/fr/tech/liste_fonctions.txt).
Les valeurs sont indiquées juste après, séparées par le caractère dièse.
Si des textes sont reçus, ils sont alors encodés au format base 64.
Contrairement à l'envoi d'une requête vers le serveur, l'ordre de réception des paramètres est importants.

Tester la présence et le bon fonctionnement du serveur

Requête envoyée au serveur :
?a=1&ip=MTkyLjE2OC4wLjEw&v=32&
Réponse du serveur (exemple) :
>F02#OK####

Récupération des options (étape 1/2)

Requête envoyée au serveur :
?a=2&v=32&ip=MTkyLjE2OC4wLjEw&x=&
Réponse du serveur (exemple) :
>F01##X#23##1#X####X#X#X######DOL3#20#2#5##X###X#X##2.0.3.225#...

Récupération des options (étape 2/2)

Requête envoyée au serveur :
?a=3&v=32&ip=MTkyLjE2OC4wLjEw&x=&
Réponse du serveur (exemple) :
>F09####dG90b0B0aXRpLmZy#MzYxNQ##...

Démarrage : ouverture de la session

Requête envoyée au serveur :
?a=4&un=VEhl&v=1.23A&ip=MTkyLjE2OC4wLjEw&c=UTRFVUZu&p=anZPa3&v_n=32&ln=FR&hr=&mn=&dt_j=&dt_m=&os=&pc=&rs=&br=&ml=&mc=&oo=&
Réponse du serveur (exemple) :
>F05#NDAz#NDg0OA##31###########

Récupérer la liste de vos contacts

Requête envoyée au serveur :
?a=12&iu=NDg2MA&is=NDAz&v=32&ip=MTkyLjE2OC4wLjEw&
Réponse du serveur (exemple) :
>F19#OK####|MzA2MTk1MTQ3MTc4MjE3MzQ...

Récupérer la liste des utilisateurs (contacts) connectés

Requête envoyée au serveur :
?a=20&iu=NDg3Mg&is=NDAz&v=32&bi=MTE3&ip=MTkyLjE2OC4wLjEw&
Réponse du serveur (exemple) :
>F16#-1#0#0##0#0#NyUyJTIlMiUyJTIlMiUyJQ##|>F16#ODEjIzQ3NTYjIyM|>F16#ODIjMCM0ODQ4IzAjIw|...

Récupérer la liste des demandes d'ajouts aux contacts en attente de confirmation

Requête envoyée au serveur :
?a=25&iu=NDg3Nw&is=NDA2&st=1&v=32&bi=MTE3&bm=MTA&ip=MTkyLjE2OC4wLjEw&
Réponse du serveur (exemple) :
>F12#-1#-1#0##0###|>F12#0#-#0#

Envoyer un message

Requête envoyée au serveur :
?a=50&u1=NDkwMg&u2=NDg0OA&s=NDA1&cr=64&m=Y291Y291&v=32&ip=MTkyLjE2OC4wLjEw&
Réponse du serveur (exemple) :
>F40#OK#15:32:14######

Recevoir un message

Requête envoyée au serveur :
?a=51&u1=NDkwMw&u2=NDg0OA&s=NDA2&c=NEVVRm&v=32&ip=MTkyLjE2OC4wLjEw&dt_f=EN&
Réponse du serveur (exemple) avec message :
>F42#OK#dGVzdA#15:44:35##64##
Réponse du serveur (exemple) sans message :
>F42#OK##h#2#0#### si aucun message.

Informations

Consulter la liste des nouveautés ainsi que la liste des prochaines améliorations (sur internet).

THeUDS © 2006 - 2012