spaceapi integration allow Hackerspaces to expose information to web apps or any other application with the SpaceAPI.
To setup the
spaceapi integration in your installation, add the following to your
# Example configuration.yaml entry spaceapi: space: HACKERSPACE_NAME logo: URL_FOR_LOGO url: URL location: address: ADDRESS contact: email: EMAIL_ADDRESS issue_report_channels: - email state: entity_id: binary_sensor.front_door
Location of the Hackerspace.
Contact information of the Hackerspace. At least one entry is mandatory.
Persons who carry a key and are able to open the space upon request. One of the fields must be specified.
Contact the person with this nickname directly in irc if available. The irc channel to be used is defined in the contact/irc field.
The reporting channel for issues. Valid values are
The current state of the Hackerspace.
The URL which is publicly accessible of the icon for the open Hackerspace.
Feeds where users can get updates of your space.
The blog of your Hackerspace.
The wiki of your Hackerspace.
The calendar of your Hackerspace.
Specifies options about caching of your SpaceAPI endpoint. Use this if you want to avoid hundreds/thousands of application instances crawling your status.
Your project sites (links to GitHub, wikis or wherever your projects are hosted).
A list of radio shows that your hackerspace might broadcast.
The list of sensors can be any sensor, not just temperature or humidity.
The SpaceAPI specification requires every sensor to provide a location. In order to set a sensor specific location do the following steps:
- Go to Configuration -> Customization
- Select the sensor entity
- Pick “Other” from the attribute override pulldown
- Set the attribute name to location and the attribute value to your desired location
If no location is set, the location defined in the HA configuration is used.
In this section you find some real-life examples of how to use this component.
A possible configuration entry for Eastermundigen, a Hackerspace in Switzerland, could look like this.
# Example configuration.yaml entry spaceapi: space: Eastermundigen logo: https://eastermundigen.ch/logo.png url: https://eastermundigen.ch location: address: "Steinbruchweg 16, 3072 Ostermundigen, Schweiz" contact: phone: "+41311111111" twitter: "@eastermundigen" email: "[email protected]" issue_report_channels: - email state: entity_id: binary_sensor.front_door" icon_open: https://eastermundigen.ch/open.png icon_closed: https://eastermundigen.ch/close.png sensors: temperature: - "sensor.temperature_in" - "sensor.temperature_out" humidity: - "sensor.humidity_in" - "sensor.humidity_out"