APIs Device to Cloud UDP Devices Send and receive IoT data

Overview

TODO

Send message to IoT device

TODO

  • Request
  • Response
POST {{API_URL}}/device-management-orchestrator/v3/{{TENANT}}/device-communication/{{nodeResourceName}}/sent-msg
Accept: application/json
Content-Type: application/json;ty=4
fullName: {{fullname}}
X-M2M-Origin: CTestApp
X-M2M-RI: 123
Authorization: Bearer {{ACCESS_TOKEN}}

{
  "m2m:cin": {
    "con": "BGVsbG8gdmlhIFVEUB==",
    "lbl": ["encode:base64"]
  }
}
HTTP/1.1 200 OK
TODO

Get last received device messages via API

TODO

  • Request
  • Response
GET {{API_URL}}/device-management-orchestrator/v3/{{TENANT}}/device-communication/<deviceID>/received-msg/la
Accept: application/json
Content-Type: application/json
X-M2M-Origin: CTestApp
X-M2M-RI: 123
Authorization: Bearer {{ACCESS_TOKEN}}
HTTP/1.1 200 OK

{
  "contentInstance": {
    "content": {
      "nodeResourceName": "device001",
      "nodeID": "urn:gsma:imei:1234567867882019",
      "time": 1752761134124,
      "messageType": "data-received",
      "status": {
        "code": 200,
        "message": "success",
        "detail": null
      },
      "data": "SGVsbG8gV29ybGQhCg==",
    },
    "contentInfo": "application/json:0",
    "resourceType": 4,
    "contentSize": 464,
    "stateTag": 12,
    "creator": "CDevice-Provisioning",
    "resourceName": "aabefd77-2166-4710-8e22-cce1c8d76312",
    "resourceID": "6879032f50fa7af1af3e4999",
    "parentID": "68767201272211da007e5999",
    "creationTime": "20250717T140535,167000",
    "lastModifiedTime": "20250717T140535,167000"
  }
}``

Message types

TODO

Error handling

TODO

Next: Forward messages to applications

In the next step, you learn how to integrate your application and use device groups to configure the data routing to your application endpoint.