Vous souhaitez utiliser l’API Discourse ? Fantastique ! Commençons.
Configurer l’environnement de développement Discourse
Configurez l’environnement de développement Discourse en utilisant notre guide pour Windows, macOS ou Ubuntu.
Cloner le Gem API Discourse
Maintenant que vous avez configuré l’environnement de développement Discourse, vous devriez déjà avoir Git et Ruby installés sur votre système. Vous pouvez installer le gem API Discourse en exécutant la commande suivante depuis la console :
git clone https://github.com/discourse/discourse_api.git ~/discourse_api
Alternativement, vous pouvez installer le gem directement :
gem install discourse_api
Installer les dépendances
Ouvrez le répertoire discourse_api et tapez :
bundle install
Ceci installera toutes les dépendances de gem requises.
Générer une clé API
Générez une clé API pour votre instance Discourse en visitant /admin/api/keys, afin d’interagir avec l’API Discourse.
Fournir les informations d’identification API
Maintenant que vous avez cloné le gem API Discourse et généré une clé API, commençons à l’utiliser !
Ouvrez le fichier discourse_api/examples/example.rb, et modifiez les informations suivantes :
client = DiscourseApi::Client.new("http://localhost:3000")
client.api_key = "VOTRE_CLE_API"
client.api_username = "VOTRE_NOM_UTILISATEUR"
Remplacez http://localhost:3000 par l’URL de votre instance discourse, par exemple : http://discourse.example.com
Remplacez VOTRE_CLE_API par la clé API de votre instance discourse, par exemple : b1f3175cb682b3e9b6ca419db77772120b19af993cbc14ebed80fea08e3bbd66
Remplacez VOTRE_NOM_UTILISATEUR par le nom d’utilisateur Admin de votre instance discourse, par exemple : codinghorror
Accéder à l’API Discourse
Maintenant, dans la console, depuis le répertoire discourse_api, exécutez :
ruby examples/example.rb
Cette commande affichera les derniers sujets de votre instance Discourse.
C’est tout. Commencez à utiliser l’API Discourse dès aujourd’hui.
Ressources supplémentaires :
Documentation de l’API Discourse
Dernière révision par @SaraDev le 2022-07-13T01:00:00Z