APIs

Acessórios e Dispositivos

Este tema contém os padrões MDM para tipos de acessórios e tipos de dispositivos

Tipos de acessórios (accessoryType)


Tipos de dispositivos (deviceType)


Modelos de rastreadores (deviceModel)

  • Descrição
    Esta entidade padroniza os seguintes atributos de tipos de dispositivos:

    • Id
    • nome
    • fabricante
  • Estrutura dos Campos

    CampoDescriçãoTipoLink
    dataIdidentificador do modelo de dispositivoint
    namenome do modelo de dispositivostring
    companyIddata.id (identificador) da empresa fabricante do dispositivointcompanyId
    companyTradeNamenome fantasia da empresa fabricante do dispositivostringcompanyName
    dataIdentifieridentificador de unicidade da entidadestring
  • Como consultar ultima versão do schema da entidade

    • Exemplo de retorno
      Clique em "JSON"
      
      {
          "statusCode": 200,
          "success": true,
          "message": "Success",
          "document": {
              "_id": "6408e4842fdf838348471ed0",
              "entityType": "deviceModel",
              "revision": 2,
              "dataIdentifierSetup": [
                  "name"
              ],
              "jsonSchema": {
                  "title": "Device Model Entity",
                  "required": [
                      "entityType",
                      "revision",
                      "data"
                  ],
                  "properties": {
                      "entityType": {
                          "title": "Device Model Entity",
                          "pattern": "^(.*)$",
                          "$id": "#/properties/entityType",
                          "type": "string"
                      },
                      "revision": {
                          "title": "The review of this entity.",
                          "default": 1,
                          "$id": "#/properties/revision",
                          "type": "integer"
                      },
                      "data": {
                          "title": "The composition of the document object.",
                          "required": [
                              "name",
                              "company"
                          ],
                          "$id": "#/properties/data",
                          "type": "object",
                          "properties": {
                              "name": {
                                  "title": "Name of Device Model.",
                                  "$id": "#/properties/data/properties/name",
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLenght": 200
                              },
                              "company": {
                                  "$id": "#/properties/data/properties/company",
                                  "type": "object",
                                  "required": [
                                      "companyId",
                                      "companyTradeName"
                                  ],
                                  "properties": {
                                      "companyId": {
                                          "title": "Value of company Id.",
                                          "$id": "#/properties/data/properties/company/properties/companyId",
                                          "type": "integer"
                                      },
                                      "companyTradeName": {
                                          "title": "Company name.",
                                          "$id": "#/properties/data/properties/company/properties/companyTradeName",
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLenght": 200
                                      }
                                  }
                              },
                              "dataId": {
                                  "title": "The Unique Key for a document of this entity. If you don't know, don't put this in the document and it will be generated automatically.",
                                  "$id": "#/properties/data/properties/dataId",
                                  "type": "integer"
                              }
                          }
                      }
                  },
                  "$id": "http://example.org/root.json#",
                  "type": "object",
                  "definitions": {},
                  "$schema": "http://json-schema.org/draft-07/schema#"
              },
              "authDefinition": {
                  "resources": {
                      "deviceModel": {
                          "create": true,
                          "update": true,
                          "delete": true,
                          "view": true
                      }
                  }
              },
              "sensiblePropertiesPath": [
                  "name",
                  "company.companyId",
                  "company.companyTradeName"
              ],
              "effectiveDate": "2023-01-23T20:38:53.056Z",
              "status": true,
              "deleted": false
          }
      }
      
  • Exemplo de chamada ao endpoint (GET) pela API get records by queryTemplate

  • Exemplo de chamada ao endpoint (GET) usando “data id”

  • Exemplo de chamada ao endpoint (GET) usando “updatedAt”

  • Exemplo de retorno

    Clique em "JSON"
    
    {
        "statusCode": 200,
        "success": true,
        "message": "Success",
        "document": [
            {
                "_id": "63cef1261dde420cf995c387",
                "entityType": "deviceModel",
                "revision": 1,
                "data": {
                    "name": "Spy",
                    "company": {
                        "companyId": 111,
                        "companyTradeName": "Jabursat"
                    },
                    "dataId": 1,
                    "dataIdentifier": {
                        "name": "Spy"
                    }
                },
                "createdAt": "2023-01-23T20:42:14.235Z",
                "updatedAt": "2023-01-23T20:42:14.235Z",
                "deleted": false,
                "userCreator": "service-account-mdm"
            },
            {
                "_id": "63cef1261dde420cf995c389",
                "entityType": "deviceModel",
                "revision": 1,
                "data": {
                    "name": "Omnifrota",
                    "company": {
                        "companyId": 184,
                        "companyTradeName": "Omnilink"
                    },
                    "dataId": 2,
                    "dataIdentifier": {
                        "name": "Omnifrota"
                    }
                },
                "createdAt": "2023-01-23T20:42:14.274Z",
                "updatedAt": "2023-01-23T20:42:14.274Z",
                "deleted": false,
                "userCreator": "service-account-mdm"
            }
        ],
        "page": 1,
        "limit": 2,
        "nextPageURL": "https://dev.nstech.com.br:8080/platform/mdm-stg/platform/api/mdm-stg/entities/deviceModel/queryByTemplate/all?page=2&limit=2"
    }