Crear dispositivo

POST

https://one.digicert.com/iot/api/v2/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)

Parámetros de la solicitud

Parámetros de la respuesta

Acerca de nosotros