Crea dispositivo

POST

https://one.digicert.com/iot/api/v1/device

Aggiungi un dispositivo da gestire.

bash

{
  "division_id": "fd5faa1e-623a-47a9-831b-b9397c33395f",
  "device_identifier": "New Device",
  "device_profile_id": "a81a431a-be7b-4f2e-8afd-b2778491511f",
  "fields": [
    {
      "id": "417c328e-604c-4e94-9112-ee58f12277fb",
      "value": "mandatory value"
    },
    {
      "id": "90eb4de2-ae8a-48a0-a904-d30c5ab6e1de",
      "value": "optional value"
    }
  ]
}

201 Created

{
  "id": "64c02969-3890-4da8-a5ef-b574fd72887e",
  "account_id": "1d1ec1ec-6502-11e9-a923-1681be663d3e",
  "division": {
    "id": "fd5faa1e-623a-47a9-831b-b9397c33395f",
    "name": "Mock Division 1"
  },
  "device_identifier": "New Device",
  "device_profile": {
    "id": "a81a431a-be7b-4f2e-8afd-b2778491511f",
    "name": "Device Profile"
  },
  "created": "2020-04-22T07:13:20Z",
  "updated": "2020-04-22T07:13:20Z",
  "status": "ACTIVE",
  "fields": [
    {
      "id": "417c328e-604c-4e94-9112-ee58f12277fb",
      "name": "Mandatory Field",
      "value": "mandatory value",
      "mandatory": true
    },
    {
      "id": "90eb4de2-ae8a-48a0-a904-d30c5ab6e1de",
      "name": "Optional Field",
      "value": "optional value",
      "mandatory": false
    }
  ]
}

400 Bad Request

{
  "errors": [
    {
      "code": "invalid_input",
      "message": "Device with division fd5faa1e-623a-47a9-831b-b9397c33395f and identifier New Device already exist"
    }
  ]
}

Parametri richiesta

Nome	Rich/Opz	Tipo	Descrizione
division_id		string	ID divisione
device_identifier		string	Identificatore dispositivo. Deve essere vuoto, max 255. Deve essere univoco all’interno della divisione
device_profile_id	obbligatorio	string	ID del profilo dispositivo da usare come modello per la creazione dispositivo
fields		array	Matrice di campi
.. id		string	ID del campo (corrisponde all’ID campo profilo dispositivo)
.. value		string	Valore del campo. Obbligatorio viene definito dal profilo dispositivo. Max 1024 simboli

Parametri di risposta

Nome	Tipo	Descrizione
id	string	ID univoco dispositivo
account_id	string	ID account
division	object	Contenitore divisione
.. id	string	ID divisione
.. name	string	Nome divisione
device_identifier	string	Identificatore dispositivo
device_profile	object	Contenitore profilo dispositivo
.. id	string	ID profilo dispositivo
.. name	string	Nome profilo dispositivo
created	string	Data e ora di creazione (UTC)
updated	string	Data e ora dell’ultimo aggiornamento (UTC)
status	string	Stato (per un dispositivo appena creato sempre ATTIVO)
fields	array	Matrice di campi
.. id	string	ID campo
.. name	string	Nome campo (dal profilo dispositivo)
.. value	string	Valore campo
.. mandatory	boolean	Il campo è obbligatorio? (vero o falso in base al profilo del dispositivo)

Parametri richiesta

Parametri di risposta

Informazioni