Chapitre 4. Les Webservices

Table des matières

4.1. Webservice de création de sujet
4.2. Webservice pour ajouter une réponse
4.3. Webservice d'édition de message
4.4. Webservice de suppression de message ou de sujet
4.5. Webservice de création d'une sous-catégorie
4.6. Webservice pour récupérer l'URL d'une sous-catégorie
4.7. Webservice pour renommer une sous-catégorie
4.8. Webservice pour effacer une sous-catégorie
4.9. Webservice pour voir les sujets d'une sous-catégorie
4.10. Webservice pour récupérer l'URL d'un sujet
4.11. Webservice pour connaitre le nombre de réponses d'un sujet et son URL
4.12. Webservice pour récupérer le contenu d'un sujet
4.13. Webservice pour récupérer le contenu d'un sujet avec offset
4.13.1. Exemple de gestion de pagination via le Webservice read_topic_page
4.14. Webservice de création d'utilisateur
4.14.1. create_user_auto
4.14.2. create_user_with_id
4.15. Webservice pour mettre à jour le mot de passe d'un utilisateur
4.16. Webservice pour mettre à jour l'email d'un utilisateur

Les forums Mesdiscussions.net comprennent un certain nombre de Webservices qui vous permettent d'intéragir avec le forum même si celui-ci n'est pas sur le même serveur que votre site.

4.1. Webservice de création de sujet

Webservice : create_topic

Ce Webservice vous permet de créer un nouveau sujet à distance sur le forum.

  • user : Pseudo d'un administrateur du forum

  • pwd : Mot de passe d'un administrateur du forum

  • author : Pseudo de l'auteur du sujet

  • idforum : ID du forum où le nouveau sujet doit être créé

  • idcat : ID de la catégorie où le nouveau sujet doit être créé

  • idsubcat : ID de la sous-catégorie où le nouveau sujet doit être créé, peut être égal à zéro si aucune sous-catégorie ne doit être spécifiée

  • title : Titre du sujet à sa création

  • text : Texte du premier message du nouveau sujet.

Voici un exemple de script de dialogue avec le webservice de création de sujet, réalisé en PHP :

require("nusoap/nusoap.php");
  
$sel = new soapclient("http://forumdev.mesdiscussions.net/webservices/wservice.php");

$param = array(
	'user' => 'LoginAdministrateur',
	'pwd'  => 'motdepasseAdministrateur',
	'author' => 'auteurdusujet',
	'idforum' => 1,
	'idcat' => 1,
	'idsubcat' => 0,
	'title' => 'Titre de l\'article qui deviendra le titre du sujet',
	'text' => 'Texte du premier message du nouveau sujet, l\'idéal étant d\'y mettre l\'article lui même.'
);
$results = $sel->call('create_topic', $param); 

Si tout se passe bien, le topic va être créé sur le forum après exécution du script. Le webservice va alors renvoyer un tableau contenant 2 paramètres si la création a réussie :

  • idtopic : Retourne l'ID du sujet créé.

  • idpost : Retourne l'ID du premier message du nouveau sujet