calendar-daysData e Hora

Esta seção contém os comandos responsáveis por consultar e atualizar a data e a hora dos controladores MG3000. Manter os relógios internos dos dispositivos sincronizados é fundamental para garantir a precisão nos registros de eventos e acessos.

1. Atualizar Data e Hora (por Instância)

Descrição:

Atualiza a data e hora do controlador MG3000 a partir da conexão com a instância especificada.

  • POST/api/1/accessControllers/instances/{id}/timestamps

Quando Usar:

Use após conectar o controlador para garantir que ele esteja sincronizado com o horário do servidor ou da rede. Fundamental após quedas de energia, reinicializações ou implantação inicial.

Atualizar a data/hora do MG3000 por Instância conectada

post

Atualizar a data/hora do MG3000 por Instância conectada

Autorizações
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
Corpo
dateTimeStampstring · date-timeOpcional
Respostas
post
/api/v1/accessControllers/instances/{id}/timestamps

2. Obter Data e Hora (por Instância)

Descrição:

Retorna a data e hora atual configurada no controlador MG3000 conectado por instância.

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

Quando Usar:

Ideal para verificar se o dispositivo está com o horário correto, especialmente durante diagnósticos, auditorias ou antes de configurar regras de acesso dependentes de horário.

Obter data e hora do controlador de acesso MG3000 por Instância conectada

get

Obter data e hora do controlador de acesso MG3000 por Instância conectada

Autorizações
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 conectada

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
chevron-right
200

Quando a obtenção da data/hora ocorrer com sucesso

application/json
get
/api/v1/accessControllers/instances/{id}/timestamps

3. Atualizar Data e Hora por ID

Descrição:

Permite ajustar a data e hora diretamente em um controlador identificado pelo seu id cadastrado no sistema.

  • POST /api/v1/accessControllers/{id}/timestamps

Quando Usar:

Utilize quando quiser sincronizar o horário de um controlador específico, sem depender de conexão por instância.

Atualizar a data/hora do MG3000

post

Atualizar a data/hora do MG3000

Autorizações
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
Corpo
dateTimeStampstring · date-timeOpcional
Respostas
post
/api/v1/accessControllers/{id}/timestamps

4. Obter Data e Hora por ID

Descrição:

Retorna a data e hora atual do controlador MG3000 referenciado diretamente pelo seu id.

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

Quando Usar:

Útil para conferência pontual da hora de um controlador cadastrado, principalmente quando a instância não está conectada.

Obter data e hora do controlador de acesso MG3000

get

Obter data e hora do controlador de acesso MG3000

Autorizações
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
chevron-right
200

Quando a obtenção da data/hora ocorrer com sucesso

application/json
get
/api/v1/accessControllers/{id}/timestamps

5. Atualizar Data e Hora com Fuso Horário (por Instância)

Descrição:

Atualiza a data e hora do controlador MG3000, incluindo o fuso horário, a partir da conexão com a instância especificada.

  • POST /api/v1/accessControllers/instances/{id}/timestamps/timezones

Quando Usar:

Útil para corrigir ou ajustar a hora de controladores conectados, garantindo a sincronização com o fuso horário correto

Atualizar a data/hora com indicação de fuso horário do MG3000 por Instância conectada

post

Atualizar a data/hora com indicação de fuso horário do MG3000 por Instância conectada

Autorizações
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
Corpo
dateTimeStampstring · date-timeOpcional
timezoneHourinteger · int32Opcional
Respostas
post
/api/v1/accessControllers/instances/{id}/timestamps/timezones

6. Atualizar Data e Hora com Fuso Horário por ID

Descrição:

Permite ajustar a data e a hora diretamente em um controlador identificado pelo seu ID cadastrado no sistema, incluindo a indicação do fuso horário.

  • POST /api/v1/accessControllers/{id}/timestamps/timezones

Quando Usar:

Para definir ou corrigir a data e hora, com indicação de fuso horário, de um controlador identificado pelo seu ID.

Atualizar a data/hora com indicação de fuso horário do MG3000

post

Atualizar a data/hora com indicação de fuso horário do MG3000

Autorizações
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
Corpo
dateTimeStampstring · date-timeOpcional
timezoneHourinteger · int32Opcional
Respostas
post
/api/v1/accessControllers/{id}/timestamps/timezones

Atualizado