The SDK is an importable Python module that facilitates API and event bus actions on EXP.
import exp
exp.runtime.start(
username="joe@exp.com",
password="joesmoe25",
host="http://localhost",
port=9000,
organization="exp")
devices = exp.api.get_devices()
devices[0].document.name = "My Device"
devices[0].save()
exp.channels.organization.broadcast(name="I changed a device!")
response = exp.channels.experience.request(name="sendMeMoney", target={
"device": devices[0].document["uuid"] })
print response
exp.runtime.stop()The SDK must be initialized by calling exp.runtime.start() and passing in configuration options. This starts the event bus and automatically authenticates API calls. The start command will block until a connection is first established.
# Authenticate with username and password.
exp.runtime.start(
username="joe@exp.com",
password="joesmoe25",
organization="exp")
# Authenticate with device uuid and secret.
exp.runtime.start(uuid="[uuid]", secret="[secret]")A socket connection is made to EXP that is non-blocking. To end the connection and to stop threads spawned by the SDK call exp.runtime.stop().
Can listen for when the event bus is online/offline. Triggers an asynchronous callback.
def on_online():
print "Online!"
def on_offline():
print "Offline!"
exp.runtime.on("online", callback=on_online)
exp.runtime.on("offline", callback=on_offline)API abstraction layer.
devices = exp.api.find_devices(**params) # Query for device objects (url params).
device = exp.api.get_device(uuid) # Get device by UUID.
device = exp.api.create_device(document) # Create a device from a dictionaryOther available namespaces: experiences, locations, content, data. contents do not currently support queries or creation, only "get_content(uuid)".
Each resource object contains a "document" field which is a dictionary representation of the raw resource, along with "save" and "delete" methods.
device = exp.api.create_device({ "field": value })
device.document["field"] = 123
device.save()
print device.document["field"]
device.delete()data = exp.api.get_data("key1", "group0")
print data.value
data.value = { "generic": 1111 }
data.save()
data.delete()
data = exp.api.create_data(key="4", group="cats", { "name": "fluffy" })The "content" resource has a get_children() method that returns the content's children (a list of content objects). Every content object also has a get_url() and get_variant_url(name) method that returns a delivery url for the content.
Parent namespace for interaction with the event bus. Available channels are:
exp.channels.system # Calls to and from the system
exp.channels.experience
exp.channels.location
exp.channels.organizationFling content on a channel.
uuid = '4abd....'
exp.channels.organization.fling(uuid)Send a request on this channel.
response = exp.channels.location.request(
name="getSomething",
target= { "device" : "[uuid]"}, payload= { "info": 123 })Attach a callback to handle requests to this device. Return value of callback is response content. Must be JSON serializable.
def get_something(payload=None):
return "Something"
exp.channels.location.respond(name="getSomething", callback=get_something_callback)Sends a broadcast message on the channel.
exp.channels.experience.broadcast(name="Hi!", payload={})Listens for broadcasts on the channel. Non-blocking, callback is spawned in new thread.
def my_method(payload=None):
print payload
exp.channels.experience.listen(name="Hi!", callback=my_method)