Gerät erstellen

Dies gilt momentan nur für Custom Products und nicht für D Zero / Masterbrick.

post
Gerät erstellen

https://api.datacake.co/v1/devices/
Mit diesem Endpunkt können Geräte angelegt werden.
Request
Response
Request
Headers
Authorization
required
string
Authentication Token.
Form Data Parameters
verbose_name
required
string
Menschen-lesbarer Name des Gerätes
product
required
string
ID des Produktes
in_workspace
required
string
ID des Workspaces, in dem das Gerät angelegt wird
claim_code
required
string
Claim / PIN code
serial_number
required
string
Eindeutige Seriennummer
particle_id
optional
string
Particle ID (falls zutreffend)
Response
201: Created
Gerät wurde erfolgreich angelegt.
{
"id": "22h7c45f-2917-358-9db1-d8a544ab78ed",
"serial_number": "22h7c45f-2917-358-9db1-d8a544ab78ed",
"verbose_name": "Gerät 1",
"online": false
}
400: Bad Request
Device with this serial number already exists.
403: Forbidden
Workspace not allowed. Please check your permissions.

Wenn Sie eine Anfrage mit einer bereits existierenden particle_id senden und Sie Administrationsberechtigungen an dem existierenden Gerät besitzen, wird die Particle-Verbindung auf das neue Gerät übertragen.