1N1nce
IoT Integrator

Create Action Requests for LwM2M Devices.

Initiate LwM2M actions like read, write, execute on the specified devices. The devices have to be connected to 1NCE LwM2M endpoint to invoke this event.

post/v1/integrate/devices/actions/LWM2M

Request

  • Base URL
    https://api.1nce.com/management-api
  • Auth
    HTTP bearer

Request body

deviceIdsstring[] required

Devices that should receive the data

action'read' | 'write' | 'execute' | 'observe-start' | 'observe-end' required

LwM2M action name to send to the devices.

resourceAddressstring required

LwM2M OMA object resource address.

datastring

Data which should be written to some resource, should be passed only in write operation.

requestMode'SEND_NOW' | 'SEND_WHEN_ACTIVE'

Action request execution mode

sendAttemptsnumber

The maximum number of attempts to send data to the devices

Example request

{
  "deviceIds": [
    "<device_id>"
  ],
  "action": "read",
  "resourceAddress": "/3/45/22",
  "data": "enable_sensor"
}

Response

Message describing the result of operation

rejectedDevicesstring[] required

A list of devices for which it was not possible to send data.

messagestring required

Message describing the result of operation.

Example response

{
  "acceptedRequests": [
    {
      "deviceId": "<device_id>",
      "requestId": "<request_id>"
    }
  ],
  "rejectedDevices": [
    "<device_id>"
  ],
  "message": "Action write for resource /3/45/22 successfuly scheduled for device _vGxHeBL0dE9LG9EB2GHj."
}

Changes

No recorded changes to this operation across all 1 revision of this API.