Hacker Zone
tools made for hackerspaces

What is the Space API?

The purpose of the Space API is to define a unified specification across the hackerspaces that can be used to expose information to web apps or any other application.

The specification is based on the JSON data interchange format. The following example shows how it looks like.

{!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "api": "0.13",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "space": "Shackspace",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "logo": "http://rescue.shackspace.de/images/logo_shack_brightbg_highres.png",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "url": "http://shackspace.de",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "location": {!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "address": "Ulmer Strasse 255, 70327 Stuttgart, Germany",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "lon": 9.236,!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "lat": 48.777!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    },!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "contact": {!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "email": "info@shackspace.de",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "irc": "irc://irc.freenode.net/shackspace",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "ml": "public@lists.shackspace.de",!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "twitter": "@shackspace"!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    },!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "state": {!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "icon": {!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
            "open": "http://shackspace.de/sopen.gif",
            "closed": "http://shackspace.de/sopen.gif"
        },!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "open": true
    },!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
    "projects": [!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
        "http://github.com/shackspace",
        "http://shackspace.de/wiki/doku.php?id=projekte"
    ]!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!
!!!THIS EXAMPLE IS NOT COMPLETE, PLEASE READ THE DOCUMENTATION!!!}

Some properties are mandatory, whereas others are optional. A hackerspace implementing this API should at least provide the mandatory fields.

Daily all the endpoints are revalidated and after a certain grace time permanent invalid implementations are likely to be removed from the directory to guarantee Space API-based applications a certain quality.

Developers that want to write a Space API-based app should take a look at the directory page.

What developers do with the API