Ce Webservice permet de récupérer le contenu d'un sujet filtré d'enrichissement. Plusieurs paramètres sont nécessaires :
idforum : ID du forum où se trouve le sujet
idcat : ID de la catégorie où se trouve la catégorie
idtopic : ID du sujet à lister
tri : ordre de récupération, 0 = ordre dans lesquels les messages ont été postés, 1 = ordre inverse
limit : Nombre maximum de messages récupérés.
Un exemple en PHP :
$param = array(
'idforum' => 1,
'idcat' => 22,
'idtopic' => 48,
'tri' => 0,
'limit' => 10
);
$results = $sel->call('read_topic', $param); Le Webservice renvoie alors plusieurs paramètres :
topictitle : Titre du sujet
nbanswer : Nombre de réponses du sujet
messages : Flux XML contenant les messages à récupérer. Ce flux XML se décompose ainsi :
<topic> <reponse id="ID de la réponse"> <auteur>Auteur de la réponse</auteur> <date>Date et heure du message</date> <message><!--[CDATA[Contenu du message]]--></message> </reponse> </topic>
Exemple :
<topic> <reponse id="108"> <auteur>Zorro</auteur> <date>02-01-2007 à 14:05:56</date> <message><!--[CDATA[Je rajoute une réponse pour le fun.]]--></message> </reponse> <reponse id="109"> <auteur>Zorro</auteur> <date>03-01-2007 à 11:04:50</date> <message><!--[CDATA[Réponse okey]]--></message> </reponse> <reponse id="110"> <auteur>EchoCedric</auteur> <date>03-01-2007 à 11:05:36</date> <message><!--[CDATA[Ceci est une réponse pour voir]]--></message> </reponse> </topic>
Le premier message du sujet n'est pas retourné, le retour commence à la première réponse.