1N1nce
Devices

Create Action Request On Specific LwM2M Device

Initiate LwM2M action like read, write, execute on specific device. It has to be connected to 1NCE LwM2M endpoint to invoke this event.

post/v1/devices/{deviceId}/actions

Request

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

Path parameters

deviceIdstring required
Example:<device_id>

The unique device ID which identifies each 1NCE SIM. Can be obtained from the Get All Devices API query. For 1NCE SIMS the device ID is equal to its iccid.

Request body

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

LwM2M action name to send to device.

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 a device

Example request

{
  "action": "read",
  "resourceAddress": "/3/45/22",
  "data": "enable_sensor"
}

Response

Message describing the result of operation

idstring required

Id of the created action request

messagestring required

Message describing the result of operation.

Example response

{
  "id": "trxHeBL0d234fsfds",
  "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.