post https://entry.xyte.io/v1/devices//children
This API requires the device to authenticate, see Device Authentication.
For a full overview of how and why you should use child devices, please first go over the Child Devices page in the Quickstart guide.
This is API reference page only.
Request Data
Name | Type | Description |
---|---|---|
sn | string | The Child device's serial number. |
model_id | string | Child's model ID (the ID of one of the models defined in the models listed in the partners portal. Model-- > Info --> Model ID) |
firmware_version | string | The current version of the child device's firmware |
name | string | Optional: Default friendly name for the device (can be changed later in the customer portal) |
details | object | Optional: Object containing internal device details. Can be used to add custom info about the device. |
Return Data
Name | Type | Description |
---|---|---|
id | string | Unique ID for this device. Must be saved and used for all future API access. |
access_key | string | Unique access key for this device. Must be saved and used for all future API access. |
Notes
- Unlike the Register Device API, the uniqueness of the Serial Number is not validated. This exception is added to support Parent Devices which are unable to retrieve a Serial Number from its child devices to communication protocol/API/etc limitations.