General

• Updating the Data Interval of a device

  The Data Interval specifies how often a device is expected to send data. This is used to determine how to automatically aggregate the data on graphs. For example, if a device is expected to send 30-minute data, setting the Data Interval to 30 minutes will ensure data is aggregated 30-minutely on graphs wherever possible. If a device only sends data daily it would not make sense to aggregate the data 30-minutely; instead, showing data aggregated daily would make more sense.Few readers

• Moving an Asset

  An asset and all child assets, devices and network nodes can be moved around the hierarchy in cThings Cloud or using the cThings Cloud API. To move an asset around the hierarchy in cThings Cloud: Navigate to the Asset Go to the Asset menu and select Move Select a new Parent Asset for the Asset to be moved Moving an Asset in cThings Cloud (https://storage.crisp.chat/users/helpdesk/website/66a70a6ed8fbb400/moving-an-asset-in-ctFew readers

• Creating an API user and generating API credentials

  You can create an API user in cThings Cloud to programmatically access your devices and data via the cThings Cloud API. You can create API keys once the API user is created. Creating an API user in cThings Cloud Navigate to Users Click New User Select API User Enter a Name and Organisation for your API user Select a Role for your API user; this will determine what API endpoints the API user can access Select an Asset that your API user can access (more assetsFew readers

cThings Cloud API

• Getting started with the cThings Cloud API

  The cThings Cloud API provides programmatic access to functionality and data available via cThings Cloud. The cThings Cloud API is a REST API that exchanges JSON data and is protected by OAuth2. This article outlines how to request an access token from the cThings AuthServer; how to use this token to make a request to the cThings Cloud API; and provides a list of available endpoints. Security Your credentials To request an access token from the cThings AuthServer you will need a usernamSome readers

Webhooks and Integrations

• Getting started with Webhooks

  What are webhooks? Webhooks allow you to subscribe to data events for a device in cThings Cloud. Every time data is received for a device, a HTTP request is made to an endpoint defined by you. This endpoint must be secure (HTTPS) and handle the transmitted data as specified below. Your webhook endpoint should look similar to the following example. https://webhooks-events.cthings.cloud The following HTTP methods are supported: DELETE GET PATCH POST PUT Creating a webhookFew readers

Advanced Customisation

• Using a custom domain (URL) with cThings Cloud

  Pointing your custom domain to cThings Cloud Create a CNAME record for your custom domain using the DNS tools provided by your DNS provider. The value of your CNAME record should point to our load balancer as detailed below.Few readers

Troubleshooting

• Troubleshooting Webhooks

  What are webhooks Webhooks can be used to automatically forward data to a HTTP destination of your choice whenever data is received in cThings Cloud. This can be useful to integrate a third-party application with a direct feed of data from your devices. Why is my webhook not triggering? Webhooks will only trigger for active devices. If you device is inactive, your webhook will not trigger. Testing webhooks You can test webhooks directly from a device in cThings Cloud. Navigate toFew readers