Requirements

Service dashboard

The following browsers are supported to use our dashboard and the documentation application:

Mozilla Firefox, latest ESR version
Google Chrome, latest stable version
Microsoft Edge, latest stable version (on Windows desktop operating systems)

HTTP based APIs

For HTTP based APIs:

HTTP 1.1 compatible client with TLS encryption support (see https://tools.ietf.org/html/rfc2616)
Optional support for WebSockets (see https://tools.ietf.org/html/rfc6455)
Optional support for Server-Sent Events (see https://www.w3.org/TR/2015/REC-eventsource-20150203/)

The configuration of the SSL/TLS layer has been limited to strong ciphers and protocols, for security reasons.

TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

For example, the following cipher suites are considered weak and are therefore no longer supported:

TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA

tip The ssl-labs online check can estimate your current browser at https://clienttest.ssllabs.com:8443/ssltest/viewMyClient.html

Java client

Oracle Java SE 8 is required to use our things-client and the ditto-client.

Resilience of devices and applications

Due to it’s nature of distributed systems and network based communication, your devices and applications need to be able to bridge small interruptions or latencies.

All usage of our service by APIs should apply a systematic approach for managing re-tries incl. an exponential back-off, as well as re-connects.

tip Find details at General re-try and re-connect guidelines.