Crear dispositivo

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

Agregar un dispositivo para administrar.

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"
    }
  ]
}

Parámetros de la solicitud

Nombre Solicitud/opción Tipo Descripción
division_id string Id. de división
device_identifier string Identificador de dispositivo. No debe estar en blanco, máximo de 255 símbolos. Debe ser único dentro de la división
device_profile_id obligatorio string Id. del perfil del dispositivo que se usará como plantilla para la creación del dispositivo
fields array Matriz de campos
.. id string Id. del campo (se corresponde con la Id. del campo del perfil del dispositivo)
.. value string Valor del campo. La obligatoriedad se define por el perfil del dispositivo. Máximo de 1024 símbolos

Parámetros de la respuesta

Nombre Tipo Descripción
id string Id. único del dispositivo
account_id string Id. de cuenta
division object Contenedor de la división
.. id string Id. de división
.. name string Nombre de la división
device_identifier string Identificador del dispositivo
device_profile object Contenedor del perfil del dispositivo
.. id string Id. del perfil del dispositivo
.. name string Nombre del perfil del dispositivo
created string Fecha y hora creados (UTC)
updated string Última actualización de fecha y hora (UTC)
status string Estado (para los dispositivos creados recientemente debe ser ACTIVO)
fields array Matriz de campos
.. id string Id. del campo
.. name string Nombre del campo (del perfil del dispositivo)
.. value string Valor del campo
.. mandatory boolean ¿Es obligatorio el campo? (verdadero o falso de acuerdo con el perfil del dispositivo)