IOT Central API

Tom Leijen 56

I am looking at using Azure IOT Central for condition monitoring of industrial machines.
My sensors will be connected to the cloud via a gateway devices that supports REST API
I would like to test the connectivity using an API simulation tool like POSTMAN, only it isn't very clear how to set up this connection.
I'm after something like this: https://stackoverflow.com/questions/58092672/azure-how-to-connect-to-iot-central-directly-via-api-or-webhook Only the poster doesn't clearly describe where he gets the 'HostName' from and how to set up the Authorisation header.
Are there any guides availabe for this?

QuantumCache 20,346 Reputation points

2020-05-20T15:38:59.14+00:00

Hi Tom,

Thanks for reaching out to us!,

We have Azure IoT Central REST API documentation.

Please see :Azure IoT Central REST API reference, as well Azure IoT Central ARM SDK examples-for creating, updating, and removing IoT Central applications. Also please refer Manage IoT Central applications with the REST API to learn more about using the REST APIs via interactive learning journey. Please let us know if you need further help.

Please accept helpful responses as 'Answer', which will be helpful to other members as well.
Tom Leijen 56 Reputation points

2020-05-20T20:00:08.817+00:00

Hi Satish,
Thanks for your reply.
I have had a look at the API references you provided.
These references explain how to use REST API for creating, updating and removing applications, but that is not what I'm looking for.
I want to be able to connect a DEVICE to my application and send data to the application from that device using HTTP API.
I have had a look at the following section in your docs: https://learn.microsoft.com/en-us/azure/iot-central/core/tutorial-connect-device-python however this example abstracts away the raw API/MQTT code, which is fine if you have a device that supports python, however not helpful if your device supports only REST API or MQTT.
Tom
QuantumCache 20,346 Reputation points

2020-05-21T04:30:07.11+00:00
Hi Tom,

Could you please make use of the below URL to post few test telemetry from your POSTMAN, lets see if you can post some telemetry to my IOT Central APP.

https://iotc-fnhbovk6iwgmxs4.azurewebsites.net/api/IoTCIntegration?code=fxtCkoL1tD8utStLKMXiVCNKPXs1RgET5cGEtQBpi2tDmHNlYeBEaQ==

Make use of the below body payload and edit the telemetry values for testing purpose. {
"device": {
"deviceId": "MyDevice1"
},
"measurements": {
"temperature": 99.31,
"pressure": 99.5,
"humidity": 3.5,
"ledColor": "red"
}
}

Headers Content-Type application/json
Tom Leijen 56 Reputation points

2020-05-21T04:41:59.973+00:00

I got it to work thanks!
QuantumCache 20,346 Reputation points

2020-05-21T04:46:15.42+00:00

Hi Tom,

Glad that your issue is unblocked now. Please mark the below response as 'Answer' which will help others as well. Please up-vote and leave a feedback on your experience with this Microsoft's Q&A community thread.

Accepted answer

QuantumCache 20,346 Reputation points

2020-05-20T20:34:15.033+00:00

Hi Tom, If I understand correctly your Device to Application (Means IoT Central Application), if Yes, then below info will help.

Please see the Build the IoT Central device bridge to connect other IoT clouds to IoT Central.

"The function app is the critical piece of the device bridge. It receives HTTP POST requests from other IoT platforms or any custom platforms via a simple webhook integration. You can easily extend this solution to connect to your custom IoT cloud if your platform can send HTTP POST requests to your function app. "

External systems can feed device data through this device bridge and into your IoT Central app by making HTTP POST requests to the function URL.

Get the IoT Central device bridge from GitHub.

Let us know if this helps your scenario.
Please sign in to rate this answer.
Tom Leijen 56 Reputation points

2020-05-20T22:01:03.343+00:00

Hi Satish,
Looking at that code, there is a lot of stuff in there to do with registering devices.
If the device is already registered manually in IOT Central, I can manually get ID Scope and SAS keys, do I still need to do that through the API?
For example when I try to call the API to get the device hub address, it requires ${response.operationId}, which it pulls from:

const registrationOptions = {
url: https://${registrationHost}/${context.idScope}/registrations/${deviceId}/register?api-version=${registrationApiVersion},
method: 'PUT',
json: true,
headers: { Authorization: sasToken },
body: { registrationId: deviceId }
};

However when I use the device sasToken from the Device Connection menu in IOT central, I get error unauthorized.

Is there not a way to push data direct to IOT Central without going through the registration process?

QuantumCache 20,346 Reputation points

2020-05-20T23:18:15.987+00:00

Hi Tom,

I have tried the IoT Central device bridge from GitHub, and was able to push telemetry data from Postman POST method. First I must create IoT Central APP and register a device to get scopeID , and device connection SAS key.
Then I have just deployed the template (Using ScopeID+SASkey) and grabbed the Function App URL and used directly in the Postman.
I mean, we should tell the bridge (function app) that where to send the data, so I believe that we need a target registered device on IoT Central.

Have you given it a try?

QuantumCache 20,346 Reputation points

2020-05-21T04:13:57.427+00:00

Hello Tom,

Here is my POSTMAN Post URL, plz try this and try to send few telemetry. I will monitor my IOTC dashboard.

URL: https://iotc-fnhbovk6iwgmxs4.azurewebsites.net/api/IoTCIntegration?code=fxtCkoL1tD8utStLKMXiVCNKPXs1RgET5cGEtQBpi2tDmHNlYeBEaQ==

Content-Type : application/json

Make use of the below body content.

{ "device": { "deviceId": "MyDevice1" }, "measurements": { "temperature": 20.31, "pressure": 50.5, "humidity": 8.5, "ledColor": "blue" } }
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.

Share via

IOT Central API

0 additional answers

Your answer