Criar dispositivo

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

Adicione um dispositivo para gerenciar.

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 da solicitação

Nome Obr/Opc Tipo Descrição
division_id string ID da divisão
device_identifier string Identificador de dispositivos. Não deve estar em branco, máximo de 255. Deve ser exclusivo com a divisão
device_profile_id obrigatório string ID do perfil do dispositivo a ser usado como um modelo para a criação de dispositivos
fields array Gama de campos
.. id string ID do dispositivo (corresponde à id do campo do perfil do dispositivo)
.. value string Valor do campo. Obrigatório é definido pelo perfil do dispositivo. Máximo de 1024 símbolos

Parâmetros da resposta

Nome Tipo Descrição
id string ID exclusiva do dispositivo
account_id string ID da Conta
division object Recipiente da divisão
.. id string ID da divisão
.. name string Nome da divisão
device_identifier string Identificador do dispositivo
device_profile object Recipiente do perfil do dispositivo
.. id string ID do perfil do dispositivo
.. name string Nome do perfil do dispositivo
created string Data e hora de criação (UTC)
updated string Última data e hora de criação (UTC)
status string Status (para dispositivo criado sempre ATIVO)
fields array Gama de campos
.. id string ID do campo
.. name string Nome do campo (do perfil do dispositivo)
.. value string Valor do campo
.. mandatory boolean O campo é obrigatório? (verdadeiro ou falso de acordo com o perfil do dispositivo)