SpaceAPIBot

From Hackerspace ACKspace
Revision as of 18:25, 24 November 2015 by Stuiterveer (talk | contribs) (added a "known bugs" section)
Jump to: navigation, search
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

  • /start - display all commands.
  • /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.

There might be some hidden commands as well.

Known bugs

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