Publishes a device’s telemetry event.
Note: This is a regional API.
You can find the URL and SystemKey required in the call by clicking API Keys (key icon) at the top-right of the Registry Details page.
The token required in the call can be found on the Registry Details page or a JWT generated (note the claims required for HTTP calls). Using the JWT is recommended since it is device-specific.
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 the start of this document on where to find the token. |
Request body
The request body contains data with this structure:
JSON representation |
|---|
{
"subFolder": string,
"gatewayInfo": {
object(GatewayInfo)
},
"binaryData": string
}
|
Fields | |
|---|---|
|
The telemetry event’s optional subfolder. This can be used to classify event types 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 a device’s behalf. |
|
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.