SGC200 Key Data
Use the powerful Netilion API to integrate your sensor’s measuring data into your system.
The FieldEdge SGC200 enables you to collect measured values by Endress+Hauser Instruments and integrate it into your system.
The FieldEdge SGC200 collects the following values from Endress+Hauser Instruments:
- Primary value (PV) incl. measuring unit and timestamp
- Secondary value (SV) incl. measuring unit and timestamp
- NE107 status incl. timestamp
The FieldEdge SGC200 supports the following technologies to connect to Endress+Hauser Instruments:
- Bluetooth (max. 5 per FieldEdge)
The FieldEdge SGC200 comes with a provided SIM card that supports the following technologies to transfer collected values to the Netilion Cloud:
- 2G/3G/4G
SGC200 Configuration
Set up the data collection and data transmission intervals in the Edge Devices configuration page according to your application needs:
The Edge Device configuration can to be done in Netilion ID Application as described here.
Please be aware it may take some time until the configuration is applied to the Edge Device.
Please note the minimum Data send interval is 15 minutes.
Accessing the data stored in the Netilion Cloud
As soon as the previous steps are done and the connection is set up, a unique digital twin of your asset is created within Netilion Cloud.
The newly created asset is identified by its serial number.
You will be able to access this information including measurement values transmitted by the FieldEdge SGC200 through the Netilion API.
In the following examples, measuring values from a sensor will be accessed through the interactive Netilion API Documentation. Alternatively, API tools such as e.g. Postman may be used as well.
Search your asset
Open the Netilion API Documentation and enter the following information:
- The API Key you created earlier
- Your Netilion username and password
Using the method GET /assets to get a list of all the assets your Netilion user has access to.
Select GET /assets, and click on Try it out.
Many filter possibilities can optionally be used.
Select Execute to run the request:
You will get a response with its http status code (1), a unique asset ID (2) and other information about this specific asset:
Remember the returned asset ID (2) for a further API request to access the measuring data attached.
Separate Netilion API endpoints exist to enable an efficient and aggregated access to your asset's measurement values:
Access the measuring data with the method GET /assets/[your asset ID]/values:
Enter the unique asset ID of your asset you retrieved earlier as shown in the figure (1).
The response returns you the latest stored values (2), comprising :
- a key corresponding to a certain measurement type
- measurements respective unit
- measurements timestamp in format YYYY-MM-DDThh:mm:ssTZD in UTC time
- the value itself
The FieldEdge SGC200 provides the following values:
- Primary measuring value (PV)
- Secondary measuring value (SV)
- Asset Status ID, where each ID corresponds to a Namur NE107 status you can separately retrieve
Access the measurement values per key with the method GET /assets/[your asset ID]/values/[key]:
Several additional filters enables you to request values from a certain key (1), optionally filtered for a specific interval (2), directly converted in a certain unit (3) or aggregated (4).
The response returns you the values as in the following example:
{
"unit": {
"id": 8815,
"href": "https://api.netilion.endress.com/v1/units/8815"
},
"latest": 29.4531459808,
"min": 28.9790496826,
"max": 31.1914844513,
"mean": 30.1711741054,
"data": [
{
"timestamp": "2019-07-15T12:00:00Z",
"value": 29.8721154841
},
{
"timestamp": "2019-07-15T16:00:00Z",
"value": 30.2796625991
},
{
"timestamp": "2019-07-15T20:00:00Z",
"value": 30.3031754891
},
{
"timestamp": "2019-07-16T00:00:00Z",
"value": 29.9560499031
},
{
"timestamp": "2019-07-16T04:00:00Z",
"value": 29.9975790998
},
{
"timestamp": "2019-07-16T08:00:00Z",
"value": 30.8338032252
},
{
"timestamp": "2019-07-16T12:00:00Z",
"value": 30.070282386
}
],
"pagination": {
"total_count": 7,
"page_count": 1,
"per_page": 500,
"page": 1
}
}
Available units can be resolved with the method GET /v1/units.
Important Note
For security purposes, we limit the amount of requests that can be made against the Netilion API:
- per user, requests are limited to 500 per minute
- per API Key, requests are limited to 1000 per minute
- per IP address, requests are limited to 2000 per minute