post
https://entry.xyte.io/v1/devices//children
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 | Required | Description |
|---|---|---|---|
| sn | string | The Child device's serial number. | |
| mac | string | MAC address. | |
| model_id | string | Yes | Child's Device Model ID (from the Partner Portal — Model → Info → Model ID). |
| firmware_version | string | Yes | 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 due to communication protocol/API/etc limitations.