Skip to content

MindSphere SDK for Python

Introduction

The MindSphere SDK for Python enables developers to work with the MindSphere IoT platform easily. It is divided into a core module and several service modules, which allows developers to include only those parts of the SDK required for their use case.

The core module provides authentication, logging, credentials configuration and a common API client implementation to access the RESTful MindSphere APIs. All service modules have dependency on the core module.

The MindSphere SDK for Python provides client implementations for the following APIs:

Name API Version
SDK Core 1.0.0
Asset Management 3.9.1
IoT Time Series 3.3.0
IoT TS Aggregates 3.1.1
IoT File Service 3.2.1
Event Analytics 3.1.1

Refer to the Getting Started for details on installation of modules and configuration of an API clients.

Get the SDK

The MindSphere SDK for Python is available for download on the Siemens Industry Online Support (SIOS) Portal [EN]/[DE]. The SDK core and service specific modules(.whl) are bundled into a ZIP file.

Features

MindSphere SDK Core

The core module of the MindSphere SDK for Python handles authorization, client configuration, error handling, logging, and a common API Client to access RESTful MindSphere platform APIs. All service modules have a dependency on the core module.

Client Configuration

You can easily configure the MindSphere SDK for Python through configuration parameters such as proxy settings, host environment and connection time-outs.

Token Handling Mechanism

The MindSphere SDK for Python provides an easy authorization mechanism. It handles technical token fetching, caching, validation and re-fetching based on user authorization tokens or service credentials as configured.

Refer to Token Handling for more information.

Logging

The MindSphere SDK for Python uses Python's built-in logging module. Logging can be enabled or disabled and set to the required level.

Refer to Logging for more information.

Error Handling

The MindSphere SDK for Python provides an error handling mechanism. Different error classes help to identify whether an error was caused by your client or by the MindSphere server. Detailed information such as error, message, HTTP status and logref are provided for investigation.

Refer to Error Handling for more information.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.