Difference between revisions of "SpaceAPIBot"

From Hackerspace ACKspace
Jump to: navigation, search
m (added SpaceAPI category)
m (Added the /help command and fixed some... stuff.)
Line 10: Line 10:
  
 
= Commands =
 
= Commands =
* '''/start''' - display all commands.
+
* '''/help''' - display all commands.
 +
* '''/start''' - display all commands. It's the same effect as using /help, this is done because a new chat with a bot is handled by sending a /start command.
 
* '''/spaces''' - display all the spaces that are currently on the list.
 
* '''/spaces''' - display all the spaces that are currently on the list.
 
* '''/default <space>''' - set a default hackerspace for displaying the state when using "''/state''". Will return an error when the space is not on the list.
 
* '''/default <space>''' - set a default hackerspace for displaying the state when using "''/state''". Will return an error when the space is not on the list.
Line 17: Line 18:
 
* '''/add <url>''' - add a space to the list using the provided URL. The URL must return a JSON object that complies with the [http://spaceapi.net/validator SpaceAPI requirements]. Will return an error when the URL doesn't provide a correct JSON object.
 
* '''/add <url>''' - add a space to the list using the provided URL. The URL must return a JSON object that complies with the [http://spaceapi.net/validator SpaceAPI requirements]. Will return an error when the URL doesn't provide a correct JSON object.
 
* '''/info''' - displays some additional information about the bot.
 
* '''/info''' - displays some additional information about the bot.
 
+
<span style="font-size:0%">Hidden commands? Why yes, of course! If you understand Dutch, try requesting the state of Henk or using a pudding command. Want to know other commands as well? Hey now, don't be greedy! Find those yourself!</span>
''There might be some hidden commands as well.''
 
  
 
= Known bugs =
 
= Known bugs =

Revision as of 13:17, 27 November 2015

Project: SpaceAPIBot
Featured:
State Active
Members Stuiterveer
GitHub No GitHub project defined. Add your project here.
Description Displays the open/close state for hackerspaces within Telegram.
Picture
No project picture! Fill in form Picture or Upload a jpeg here

Synopsis

This bot can be used to display the open/close states for multiple hackerspaces within Telegram, using the JSON attributes for SpaceAPI. The bot can also be used within group chats. To start a new chat with this bot, send a message to "SpaceAPIBot".

The reason behind the bot was to provide a "central" hub (comparable to the SpaceAPI directory, but you can also add spaces that are not in this directory, as long as they comply with the API requirements) for displaying multiple hackerspaces and displaying their state without having to navigate to one or multiple web pages.

Commands

  • /help - display all commands.
  • /start - display all commands. It's the same effect as using /help, this is done because a new chat with a bot is handled by sending a /start command.
  • /spaces - display all the spaces that are currently on the list.
  • /default <space> - set a default hackerspace for displaying the state when using "/state". Will return an error when the space is not on the list.
  • /state - display the state for the space that's set to default. Will return an error when no default is set. An extra parameter can be added:
    • /state <space> - display the state for the space that's entered. Will return an error when the space is not on the list.
  • /add <url> - add a space to the list using the provided URL. The URL must return a JSON object that complies with the SpaceAPI requirements. Will return an error when the URL doesn't provide a correct JSON object.
  • /info - displays some additional information about the bot.

Hidden commands? Why yes, of course! If you understand Dutch, try requesting the state of Henk or using a pudding command. Want to know other commands as well? Hey now, don't be greedy! Find those yourself!

Known bugs

  • A lot of special characters in UTF-8 don't work correctly with the bot.