Things5 is the IoT platform from Visup to connect, monitor and manage a fleet of machines. Most of what you can do in the Things5 web platform is also available through its APIs.
APIs
| API | For | Base address |
|---|---|---|
| HTTP API | Integrations, applications and scripts (cloud to cloud) | https://api.things5.digital/v1 |
| HTTP API Recipes | Recipes, recipe templates and cookbooks | https://api.things5.digital/v1/recipes |
| MQTT API | Devices: sending data, receiving commands, parameters, firmware and recipes | v2.mqtt.things5.digital:8883 (see Connecting a device) |
With the HTTP API you can, for example:
- list devices, models and groups, and read device details (Device list, Device details)
- read data: metrics, states and events (Metrics read, States read, Events read) and export it
- read and write device parameters, send commands and actions, update firmware
- manage users, roles, groups, plans and notifications
- send data from a server instead of a device (Data ingestion)
With the MQTT API a device can send telemetry, receive parameter, command, firmware and recipe requests and answer them. MQTT is for devices only, not for cloud-to-cloud integrations.
First steps
- Authentication: get an access token, see Authentication.
- Identifiers: find your realm, organization and device ids, see General parameters.
- Devices: create a device model and firmware in the web platform, create the device, then connect it with a certificate: see Secure device provisioning and Connecting a device.
The video first steps in the platform covers creating a device model, a firmware version and a device, sending data and debugging in the MQTT console. More video guides are on the YouTube channel.
Access
API access uses your Things5 account or an API integration of your organization. If you do not have access to Things5 yet, ask your Things5 provider.
