Publishes a telemetry event for a device.
You can find the URL, SystemKey, and token required in the call by clicking on API Keys (key icon) at the top-right of the Registry Details page.
HTTP request
POST {URL}/api/v/4/webhook/execute/{SystemKey}/cloudiotdevice_devices
Query parameters
Parameters | |
|---|---|
|
The device’s name. For example, or
The device’s name can be set to the deviceId or numId (i.e., without the project, location, and registry info. prepended). |
|
The value must be |
Header parameters
Parameters | |
|---|---|
| See the note at start of this document on where to find the token. |
Request body
The request body contains data with the following structure:
...
Fields | |
|---|---|
|
Optional subfolder for the telemetry event. This can be used to classify types of events and is included in the Pub/Sub message attributes. |
|
Set only if the message is sent through a gateway or a gateway is making the request on behalf of a device. |
|
Payload data in binary format. A base64-encoded string. |
Response status codes
Code | Meaning |
|---|---|
204 | Success |
Response body
If successful, the response body will be empty.