Firmware

Esta seção reúne os comandos voltados para a verificação da versão do firmware instalada nos controladores de acesso MG3000. Essa informação é essencial para identificar compatibilidades com funcionalidades específicas, planejar atualizações e diagnosticar possíveis comportamentos inesperados relacionados ao software embarcado.

1. Obter Versão do Firmware (por Instância)

Descrição:

Consulta a versão do firmware do controlador MG3000 conectado via instância.

• GET /api/v1/accessControllers/instances/{id}/versions

Quando Usar:

Recomenda-se utilizar ao conectar um dispositivo para garantir que ele esteja com uma versão compatível com os recursos disponíveis no sistema. Também é útil durante diagnósticos e planejamentos de upgrade.

Obter a versão do firmware do controlador de acesso MG3000 por Instância conectada

get

Obter a versão do firmware do controlador de acesso MG3000 por Instância conectada

Autorizações

BearerApiKey

AuthorizationstringObrigatório

JWT Authorization header using the Bearer scheme.

Enter 'Bearer'[space] and then your token in the text input below.

Example: "Bearer 12345abcdef"

Parâmetros de rota

idinteger · int32Obrigatório

Id da instância da conexão

Parâmetros de consulta

cultureNamestringOpcional

Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)

Default: en-US

Respostas

200

Quando a obtenção da versão ocorrer com sucesso

application/json

400

Quando ocorrer erro

application/json

get

/api/v1/accessControllers/instances/{id}/versions

HTTPcURLJavaScriptPython

GET /api/v1/accessControllers/instances/{id}/versions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "failure": true,
  "data": {
    "version": {
      "majorVersion": "text",
      "minorVersion": "text",
      "release": "text",
      "build1": "text",
      "build2": "text",
      "fullVersion": "text"
    }
  }
}

---

2. Obter Versão do Firmware (por ID)

Descrição:

Retorna a versão do firmware de um controlador MG3000 identificado diretamente pelo seu id no sistema.

• GET /api/v1/accessControllers/{id}/versions

Quando Usar:

Use este comando quando for necessário consultar a versão do firmware de um controlador já cadastrado no sistema, mesmo sem conexão ativa.

Obter a versão do firmware do controlador de acesso MG3000

get

Obter a versão do firmware do controlador de acesso MG3000

Autorizações

BearerApiKey

AuthorizationstringObrigatório

JWT Authorization header using the Bearer scheme.

Enter 'Bearer'[space] and then your token in the text input below.

Example: "Bearer 12345abcdef"

Parâmetros de rota

idinteger · int64Obrigatório

Id do controlador de acesso

Parâmetros de consulta

cultureNamestringOpcional

Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)

Default: en-US

Respostas

200

Quando a obtenção da versão ocorrer com sucesso

application/json

400

Quando ocorrer erro

application/json

get

/api/v1/accessControllers/{id}/versions

HTTPcURLJavaScriptPython

GET /api/v1/accessControllers/{id}/versions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "failure": true,
  "data": {
    "version": {
      "majorVersion": "text",
      "minorVersion": "text",
      "release": "text",
      "build1": "text",
      "build2": "text",
      "fullVersion": "text"
    }
  }
}