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)