Python REST Client for consuming the Losant IoT Platform API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
examples
losantrest
schemas
tests
.gitignore
.markdownlint.json
.python-version use a python-version file Feb 7, 2017
.travis.yml don't support 3.2, since requests itself doesn't support 3.2 Feb 7, 2017
LICENSE
MANIFEST.in not using rst, need to include the md readme Jun 14, 2016
README.md
setup.py

README.md

Losant Python REST API Client

Build Status PyPI version

The Losant REST API client provides a simple way to use the comprehensive Losant API. You can authenticate either as a Losant device or with your user account, and have access to all the functionality of the Losant platform.

This client works with both Python 2.7 and 3. It uses Requests under the covers for the actual HTTP communication.


Installation

The latest stable version is available in the Python Package Index (PyPi) and can be installed using

pip install losant-rest

Example

Below is a high-level example of using the Losant Python REST API client to authenticate against the Losant Platform and report state for a device.

from losantrest import Client
from analog import AnalogSensor

client = Client()
creds = {
    'deviceId': 'my-device-id',
    'key': 'my-app-access-key',
    'secret': 'my-app-access-secret'
}
response = client.auth.authenticate_device(credentials=creds)

client.auth_token = response['token']
app_id = response['applicationId']

state = {'data': {'temperature': AnalogSensor.read()}}
response = client.device.send_state(deviceId='my-device-id',
    applicationId=app_id, deviceState=state)

print(response)
""" {'success': True} """

API Documentation

Client

A client is a single api instance. By default, it is unauthenticated, but can be given an access token to perform authenticated requests.

Constructor

Client(auth_token=None, url="https://api.losant.com")

The Client() constructor takes the following arguments:

  • auth_token
    The access token to be used for authentication - by default there is no access token. An access token can be acquired through any of the Auth methods, or can be created for a particular application through application_api_tokens.

  • url
    The url of the Losant API - by default https://api.losant.com.

Properties

  • auth_token
    The access token can be accessed or changed after Client creation through this property.

  • url
    The api base url can be accessed or changed after Client creation through this property.

Resources

Each of the following is a property on the client object, and returns a wrapper for the actions against that particular resource. See each resource documentation file for more information.

  • application_api_token
    Contains all the actions that can be performed against a single Api Token belonging to an application - for instance, getting info on a single token or revoking a token.

  • application_api_tokens
    Contains all of the actions that can be performed against the collection of Api Tokens belonging to an Application - such as listing all tokens or creating a new token.

  • application_key
    Contains all the actions that can be performed against a single Application Key - for instance, getting info on a single key or revoking a key.

  • application_keys
    Contains all of the actions that can be performed against the collection of Application Keys belonging to an Application - such as listing all keys or creating a new key.

  • application
    Contains all of the actions that can be performed against a single Application, which include things like getting info on an application or modifying an application.

  • applications
    Contains all of the actions that can be performed against the set of Applications that the currently authenticated user has access to - such as listing the applications or creating a new application.

  • auth
    Contains the actions used for authenticating against the api, either as a user or as a device. The result of authentication calls contain the auth_token needed for authenticated calls - see the examples for more details.

  • dashboard
    Contains all of the actions that can be performed against a single Dashboard, which include things like getting info on a dashboard or modifying a dashboard.

  • dashboards
    Contains all of the actions that can be performed against the set of Dashboards that the currently authenticated user has access to - such as listing the dashboards or creating a new dashboard.

  • data
    Contains the actions for querying against historical Device data across an Application.

  • data_table
    Contains all the actions that can be performed against a single Data Table - for instance, getting info on a single data table or modifying the columns of a data table.

  • data_tables
    Contains all of the actions that can be performed against the collection of Data Tables belonging to an Application - such as listing all data tables or creating a new data table.

  • data_table_row
    Contains all the actions that can be performed against a single row inside of a Data Table - for instance, getting the contents of a row, or modifying a row.

  • data_table_rows
    Contains all of the actions that can be performed against the collection of rows that make up a Data Table - such as querying for rows in that table, or adding a new row to the table.

  • device
    Contains all the actions that can be performed against a single Device - for instance, getting info on a single device or reporting the current state of a device.

  • devices
    Contains all of the actions that can be performed against the collection of Devices belonging to an Application - such as listing all devices or sending a command to a set of devices.

  • device_recipe
    Contains all the actions that can be performed against a single Device Recipe, which include things like removing a device recipe or creating a device from a device recipe.

  • device_recipes
    Contains all the actions that can be performed against the collection of Device Recipes belonging to an Application - such as listing recipes or creating a new recipe.

  • edge_deployments
    Contains all the actions that can be performed against the collection of Edge Deployments belonging to an Application - such as listing deployments or creating a new deployment.

  • event
    Contains all the actions that can be performed against a single Event, such as commenting on or changing the state of an event.

  • events
    Contains all the actions that can be performed against the collection of Events belonging to an Application - such as listing open events or creating a new event.

  • experience_domain
    Contains all the actions that can be performed against a single Experience Domain, such as updating SSL certificate information.

  • experience_domains
    Contains all the actions that can be performed against the collection of Experience Domains belonging to an Application - such as listing domains or creating a new domain.

  • experience_endpoint
    Contains all the actions that can be performed against a single Experience Endpoint, such as updating route information.

  • experience_endpoints
    Contains all the actions that can be performed against the collection of Experience Endpoints belonging to an Application - such as listing endpoints or creating a new endpoint.

  • experience_group
    Contains all the actions that can be performed against a single Experience Group, such as updating member information.

  • experience_groups
    Contains all the actions that can be performed against the collection of Experience Groups belonging to an Application - such as listing groups or creating a new group.

  • experience_user
    Contains all the actions that can be performed against a single Experience User, such as changing their email or password.

  • experience_users
    Contains all the actions that can be performed against the collection of Experience Users belonging to an Application - such as listing users or creating a new user.

  • experience_view
    Contains all the actions that can be performed against a single Experience View, such as modifying the body template.

  • experience_views
    Contains all the actions that can be performed against the collection of Experience Views belonging to an Application - such as listing views or creating a new view.

  • file
    Contains all the actions that can be performed against a single File, such as moving, renaming, or deleting.

  • files
    Contains all the actions that can be performed against the collection of Files belonging to an Application - such as listing files or uploading a new file.

  • flow
    Contains all the actions that can be performed against a single Workflow, such as enabling or disabling a workflow, or triggering a virtual button in the workflow.

  • flows
    Contains all the actions that can be performed against the collection of Workflows belonging to an Application - such as listing the workflows or creating a new workflow.

  • flow_version
    Contains all the actions that can be performed against a single Workflow Version, such as enabling or disabling a workflow version, or updating the version notes.

  • flow_versions
    Contains all the actions that can be performed against the collection of Workflow Versions belonging to a Workflow - such as listing the versions or creating a new version.

  • me
    Contains the actions for operating against the currently authenticated User such as changing the password or linking against external services.

  • integration
    Contains all the actions that can be performed against a single Integration, which include things like removing an integration or updating integration configuration.

  • integrations
    Contains all the actions that can be performed against the collection of Integrations belonging to an Application - such as listing integrations or creating a new integration.

  • org
    Contains all the actions that can be performed against a single Organization, things like inviting a user to the organization, or modifying the organization.

  • orgs
    Contains all of the actions that can be performed against the set of Organizations that the currently authenticated user has access to - such as listing the organizations or creating a new organization.

  • webhook
    Contains all the actions that can be performed against a single Webhook, for instance modifying the verification settings or removing the webhook.

  • webhooks
    Contains all the actions that can be performed against the collection of Webhooks belonging to an Application - such as listing the webhooks or creating a new webhook.



Copyright (c) 2018 Losant IoT, Inc

https://www.losant.com