API Rest do Portal de Telemetria
v0
v1
alarms > list
Obtém a lista de alarmes do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
name | Texto com o nome do alarme. |
ids | Valores inteiros separados por virgula com os identificadores dos alarmes. |
connector_id | Valor inteiro com o identificador do conector associado ao alarme. |
connector_name | Texto com o nome do conector associado ao alarme. |
device_id | Valor inteiro com o identificador do dispositivo associado ao alarme. |
device_name | Texto com o nome do dispositivo associado ao alarme. |
data_id | Valor inteiro com o identificador do dado associado ao alarme. |
data_ids | Valores inteiros separados por virgula com os identificadores dos dados. |
data_name | Texto com o nome do dado associado ao alarme. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao alarme. |
process_area_name | Texto com o nome da área de processo associada ao alarme. |
contract_id | Valor inteiro com o identificador do contrato associado ao alarme. |
enabled | Valor booleano de identificação do estado de habilitação do recurso no sistema. |
base_model | Valor booleano de identificação se o recurso é de modelo. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
alarms > create
Cria um alarme no sistema.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do alarme. |
description | Valor texto com a descrição do alarme |
data_id required | Valor inteiro com o identificador do dado associado ao alarme. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao alarme. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao alarme deve ser herdada do dado. |
alarm_trigger_condition_id required | Valor inteiro com o identificador da condição de disparo do alarme. |
limit | Valor real de limite para ativação do alarme. |
enabled | Valor booleano que indica se o alarme está habilitado no sistema. |
acknowledgment_enabled | Valor booleano que indica se o reconhecimento está habilitado para o alarme. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
alarms > read
Obtém os detalhes de configuração de um determinado alarme.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do alarme. |
alarms > partial_update_0
Atualiza as informações de configuração de um alarme.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do alarme. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name | Valor texto com o nome do alarme. |
description | Valor texto com a descrição do alarme |
data_id | Valor inteiro com o identificador do dado associado ao alarme. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao alarme. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao alarme deve ser herdada do dado. |
alarm_trigger_condition_id | Valor inteiro com o identificador da condição de disparo do alarme. |
limit | Valor real de limite para ativação do alarme. |
enabled | Valor booleano que indica se o alarme está habilitado no sistema. |
acknowledgment_enabled | Valor booleano que indica se o reconhecimento está habilitado para o alarme. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
alarms > delete
Remove um determinado alarme da base de alarmes.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do alarme. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
alarms > clear_history > create
Remove os registros de históricos de um alarme do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do alarme a serem removidos os registros do(s) histórico(s). |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
history_type required | Valor texto com o tipo do histórico a serem removidos os registros. Valor para cada tipo:
|
reason required | Valor texto com a descrição do motivo para remoção dos registros do(s) histórico(s). Este registro poderá ser consultado posteriormente no histórico de eventos do sistema. |
cutting_datetime | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de corte para remoção de registros do(s) histórico(s). Ou seja, todos os registros iguais ou anteriores a data/hora fornecida serão removidos. Caso não seja fornecido este parâmetro, todos os registros serão removidos do(s) histórico(s) para o recurso selecionado. |
alarms > duplicate > create
Duplica o cadastro de um alarme no Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do alarme a ser duplicado. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do alarme utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do alarme. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do alarme. |
description | Valor texto com a descrição do alarme |
data_id | Valor inteiro com o identificador do dado associado ao alarme. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao alarme. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao alarme deve ser herdada do dado. |
alarm_trigger_condition_id | Valor inteiro com o identificador da condição de disparo do alarme. |
limit | Valor real de limite para ativação do alarme. |
enabled | Valor booleano que indica se o alarme está habilitado no sistema. |
acknowledgment_enabled | Valor booleano que indica se o reconhecimento está habilitado para o alarme. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
data | Dado relativo ao comando. |
alarm | Alarme relativo ao comando. |
value | Valor relativo ao comando. |
alarms_history > list
Obtém a lista do histórico de eventos dos alarmes do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
connector_id | Valor inteiro com o identificador do conector associado ao alarme do histórico. |
device_id | Valor inteiro com o identificador do dispositivo associado ao alarme do histórico. |
data_id | Valor inteiro com o identificador do dado associado ao alarme do histórico. |
alarm_id | Valor inteiro com o identificador do alarme associado ao histórico. |
alarm_ids | Valores inteiros com os identificadores dos alarmes associados ao histórico. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao alarme do histórico. |
contract_id | Valor inteiro com o identificador do contrato associado ao alarme do histórico. |
start | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-01 08:00:00) de início para recuperação de registros no histórico. |
end | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de fim para recuperação de registros no histórico. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
auth > login > create
Recebe um conjunto de credenciais do usuário e retorna um token no formato JWT (JSON Web Token) ou recebe um JWT via o cabeçalho da requisição e retorna as informações do usuário associado o token. O token gerado tem validade de 4 HORAS e pode ser renovado por até 1 DIA através do endpoint de refresh
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
Authorization | Deve ser fornecido um JSON Web Token(JWT) válido para o login em que se deseja obter as informações do usuário associado ao token. Utilize essa alternativa em relação ao login via credenciais do usuário. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
email required | Valor texto com o endereço de e-mail do usuário. |
password required | Valor texto codificado em Base64 contendo a senha do usuário. |
auth > login_refresh > create
Recebe um token no formato JWT (JSON Web Token) e retorna um novo token atualizado.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
token required | JSON Web Token(JWT) válido para o login em que se deseja atualizar a data de expiração do token. |
auth > logout > create
Recebe um token no formato JWT (JSON Web Token) associado ao usuário que se deseja realizar o logout.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
token required | JSON Web Token(JWT) válido para o login que se deseja realizar o logout. |
auth > password_change > create
Realiza a troca de senha de um usuário do Portal de Telemetria.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
old_password required | Valor texto codificado em Base64 contendo a senha atual do usuário. |
new_password1 required | Valor texto codificado em Base64 contendo a nova senha do usuário. |
new_password2 required | Valor texto codificado em Base64 contendo a confirmação da nova senha do usuário. |
auth > users > list
Obtém a lista de usuários do Portal de Telemetria.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
contract_id | Valor inteiro com o identificador do contrato associado aos usuários. |
contract_ids | Lista contendo os valores inteiros de identificação dos usuários. |
email | Valor texto com o endereço de email do usuário. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
auth > users > read
Obtém os detalhes de configuração de um usuário.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do usuário. |
auth > users > partial_update
Atualiza as informações de configuração de um determinado usuário.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do usuário. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
first_name | Valor texto com o nome do usuário. |
last_name | Valor texto com o sobrenome do usuário. |
user_profile | Objeto JSON com a definição de informações de profile do usuário. |
associated_permissions | Objeto JSON com as definições das informações de permissões do usuário. |
commands > list
Obtém a lista de comandos sobre recursos do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
command_type_id | Valor inteiro com o identificador do do tipo associado ao comando. |
data_id | Valor inteiro com o identificador do do dado associado ao comando. |
alarm_id | Valor inteiro com o identificador do do alarme associado ao comando. |
command_state_id | Valor inteiro com o identificador do do estado associado ao comando. |
command_result_id | Valor inteiro com o identificador do do resultado associado ao comando. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
commands > create
Cria um comando sobre recursos do sistema.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
command_type_id required | Valor inteiro com o identificador do tipo de commando. |
parameters required | Objeto JSON com a definição dos parâmetros do comando de acordo com seu tipo. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
commands > read
Obtém os detalhes de configuração de um comando,
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do comando. |
commands > partial_update
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do comando. |
commands > delete
Remove um determinado comando da base de dados.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do comando. |
connectors > list
Obtém a lista de conectores do Portal de Telemetria.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
name | Texto com o nome do conector. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao conector. |
process_area_name | Texto com o nome da área de processo associada ao conector. |
contract_id | Valor inteiro com o identificador do contrato associado ao conector. |
enabled | Valor booleano de identificação do estado de habilitação do recurso no sistema. |
base_model | Valor booleano de identificação se o recurso é de modelo. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
connectors > create
Cria um conector no Portal de Telemetria.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do conector. |
description | Valor texto com a descrição do conector. |
connector_type_id required | Valor inteiro com o identificador do tipo de conector associado ao conector. |
protocol_id | Valor inteiro com o identificador do protocolo de comunicação associado ao conector. |
contract_id required | Valor inteiro com o identificador do contrato associado ao conector. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao conector. |
enabled | Valor booleano que indica se o conector está habilitado no Portal de Telemetria. |
location_name required | Valor texto com o nome da localização geográfica do conector. |
location_address | Objeto JSON com a definição de dados da localização geográfica do conector. |
serial_number required | Valor texto com a identificação do número de série do conector. |
timezone | Valor texto com a identificação do timezone associado ao conector. |
updates_datetime | Valor booleano que indica se o Portal de Telemetria deve atualizar a data/hora do conector. |
optimizes_frames | Valor booleano que indica se o Portal de Telemetria deve otimizar os frames de comunicação com o conector. |
pooling_interval | Valor inteiro com a taxa de atualização(em segundos) dos valores de dados associados ao conector. O valor mínimo é de 30 segundos. |
base_model | Valor booleano que indica se o conector é de modelo(para outros conectores). |
base_model_id | Valor inteiro com o identificador do conector de modelo associado ao conector. |
apply_changes_to_instances | Valor booleano que indica se as alterações realizadas no recurso de modelo devem ser aplicadas nos recursos associados(instâncias). Este atributo não é persistido em base de dados. |
portal_data | Objeto JSON com a definição de dados customizados pelo Portal de Telemetria. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
connectors > read
Obtém os detalhes de configuração de um determinado conector.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do conector. |
connectors > partial_update_0
Atualiza as informações de configuração de um conector.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do conector. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name | Valor texto com o nome do conector. |
description | Valor texto com a descrição do conector. |
connector_type_id | Valor inteiro com o identificador do tipo de conector associado ao conector. |
protocol_id | Valor inteiro com o identificador do protocolo de comunicação associado ao conector. |
contract_id | Valor inteiro com o identificador do contrato associado ao conector. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao conector. |
enabled | Valor booleano que indica se o conector está habilitado no Portal de Telemetria. |
location_name | Valor texto com o nome da localização geográfica do conector. |
location_address | Objeto JSON com a definição de dados da localização geográfica do conector. |
serial_number | Valor texto com a identificação do número de série do conector. |
timezone | Valor texto com a identificação do timezone associado ao conector. |
updates_datetime | Valor booleano que indica se o Portal de Telemetria deve atualizar a data/hora do conector. |
optimizes_frames | Valor booleano que indica se o Portal de Telemetria deve otimizar os frames de comunicação com o conector. |
pooling_interval | Valor inteiro com a taxa de atualização(em segundos) dos valores de dados associados ao conector. O valor mínimo é de 30 segundos. |
base_model | Valor booleano que indica se o conector é de modelo(para outros conectores). |
base_model_id | Valor inteiro com o identificador do conector de modelo associado ao conector. |
apply_changes_to_instances | Valor booleano que indica se as alterações realizadas no recurso de modelo devem ser aplicadas nos recursos associados(instâncias). Este atributo não é persistido em base de dados. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
connectors > delete
Remove um determinado conector do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do conector. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
connectors > clear_history > create
Remove os registros de históricos de um conector do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do conector a serem removidos os registros do(s) histórico(s). |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
history_type required | Valor texto com o tipo do histórico a serem removidos os registros. Valor para cada tipo:
|
reason required | Valor texto com a descrição do motivo para remoção dos registros do(s) histórico(s). Este registro poderá ser consultado posteriormente no histórico de eventos do sistema. |
cutting_datetime | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de corte para remoção de registros do(s) histórico(s). Ou seja, todos os registros iguais ou anteriores a data/hora fornecida serão removidos. Caso não seja fornecido este parâmetro, todos os registros serão removidos do(s) histórico(s) para o recurso selecionado. |
connectors > duplicate > create
Duplica o cadastro de um conector no Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do conector a ser duplicado. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do conector utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do conector. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do novo conector. |
description | Valor texto com a descrição do conector. |
serial_number required | Valor texto com a identificação do número de série do novo conector. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao conector. |
enabled | Valor booleano que indica se o conector está habilitado no Portal de Telemetria. |
location_name | Valor texto com o nome da localização geográfica do conector. |
location_address | Objeto JSON com a definição de dados da localização geográfica do conector. |
timezone | Valor texto com a identificação do timezone associado ao conector. |
contract_id | Valor inteiro com o identificador do contrato associado ao conector. |
pooling_interval | Valor inteiro com a taxa de atualização(em segundos) dos valores de dados associados ao conector. O valor mínimo é de 30 segundos. |
base_model | Valor booleano que indica se o conector é de modelo(para outros conectores). |
base_model_id | Valor inteiro com o identificador do conector de modelo associado ao conector. |
portal_data | Objeto JSON com a definição de dados customizados pelo Portal de Telemetria. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
contracts > member_users > read
Obtém os detalhes de configuração de um determinado membro de um contrato.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato. |
id required | Valor inteiro com o identificador do usuário membro. |
contracts > member_users > partial_update
Atualiza as informações de configuração de um determinado membro de um contrato.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato. |
id required | Valor inteiro com o identificador do usuário membro. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
associated_permissions | Objeto JSON com as definições das informações de permissões do usuário. |
first_name | Valor texto com o nome do usuário(membro). |
last_name | Valor texto com o sobrenome do usuário(membro). |
password1 | Valor texto codificado em Base64 contendo a senha do usuário(membro). |
password2 | Valor texto codificado em Base64 contendo a confirmação da senha do usuário(membro). |
requires_password_change | Valor booleano para indicação de que o usuário(membro) deve alterar a sua senha. |
reason_password_change | Valor texto para motivo que usuário(membro) deve alterar a sua senha. |
blocks_password_change | Valor booleano para indicação de que o usuário(membro) poderá alterar a sua senha. |
contracts > member_users > delete
Remove um determinado membro de um contrato.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato. |
id required | Valor inteiro com o identificador do usuário membro. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
contracts > member_users > list
Obtém as listas de membros de um contrato do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
email | Valor texto com o endereço de email do membro do contrato. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-email |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
contracts > member_users > create
Associa um usuário como membro de um contrato no Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
email required | Valor texto com o endereço de e-mail do usuário a ser associado como membro do contrato. Caso o usuário já exista, o mesmo será adicionado como membro do contrato. Caso não, o atributo create_user será verifica para sedeterminar se um usuário deve ser criado para o endereço de e-mail fornecido |
create_user | Valor booleano para indicação de criação de um usuário associado ao endereço de e-mail fornecido caso não exista um usuário associado ao e-mail. Após a criação do usuário, este será associado como membro do contrato. |
first_name | Valor texto com o nome do usuário(válido somente se o atributo create_user for fornecido com o valor true). |
last_name | Valor texto com o sobrenome do usuário(válido somente se o atributo create_user for fornecido com o valor true). |
password1 | Valor texto codificado em Base64 contendo a senha do usuário(válido somente se o atributo create_user for fornecido com o valor true). |
password2 | Valor texto codificado em Base64 contendo a confirmação da senha do usuário(válido somente se o atributo create_user for fornecido com o valor true). |
requires_password_change | Valor booleano para indicação de que o usuário(membro) deve alterar a sua senha(válido somente se o atributo create_user for fornecido com o valor true). |
reason_password_change | Valor texto para indicação do motivo que usuário(membro) deve alterar a sua senha(válido somente se o atributo create_user for fornecido com o valor true). |
blocks_password_change | Valor booleano para indicação de que o usuário(membro) não poderá trocar a sua senha (válido somente se o atributo create_user for fornecido com o valor true). |
associated_permissions | Objeto JSON com as definições das informações de permissões do usuário. |
data > list
Obtém a lista de dados do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
name | Texto com o nome do dado. |
ids | Valores inteiros separados por virgula com os identificadores dos dados. |
connector_id | Valor inteiro com o identificador do conector associado ao dado. |
connector_name | Texto com o nome do conector associado ao dado. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado. |
device_name | Texto com o nome do dispositivo associado ao dado. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado. |
process_area_name | Texto com o nome da área de processo associada ao dado. |
contract_id | Valor inteiro com o identificador do contrato associado ao dado. |
enabled | Valor booleano de identificação do estado de habilitação do recurso no sistema. |
base_model | Valor booleano de identificação se o recurso é de modelo. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
data > create
Cria um dado no sistema.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do dado. |
description | Valor texto com a descrição do dado. |
device_id required | Valor inteiro com o identificador do dispositivo associado ao dado. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dado deve ser herdada do dispositivo. |
memory_type_id required | Valor inteiro com o identificador do tipo de memória associado ao dado. |
memory_address | Valor inteiro com o endereço do dado. |
unity_label | Valor texto com a unidade de engenharia associado ao dado. |
value_format_type_id | Valor inteiro com identificador do tipo de formatação do valor do dado. |
update_value_mode_after_writing_id | Valor inteiro com identificador do modo de atualização do valor do dado após um comando de escrita. |
read_only | Valor booleano que indica se o dado é desomente leitura. |
enabled | Valor booleano que indica se o dado está habilitado no sistema. |
history_enabled | Valor booleano que indica se o valor do dado de ser historiado pelo sistema. |
source_value_id required | Valor inteiro com o identificador da fonte de coleta do valor do dado. |
local_storage_identity_number | Valor inteiro com o identificador da posição do dado no buffer da base local decoleta de dados. |
calculation_type_id | Valor inteiro com o identificador do tipo de cálculo associado ao dado. |
calculation_param_a | Valor texto associado ao primeiro parâmetro do tipo de cálculo. |
calculation_param_b | Valor texto associado ao segundo parâmetro do tipo de cálculo. |
calculation_param_c | Valor texto associado ao terceiro parâmetro do tipo de cálculo. |
calculation_param_d | Valor texto associado ao quarto parâmetro do tipo de cálculo. |
text_list_id | Valor inteiro com o identificador do da lista de texto associado ao dado. |
minimum_value | Valor real mínimo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
maximum_value | Valor real máximo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
data > read
Obtém os detalhes de configuração de um determinado dado.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dado. |
data > partial_update_0
Atualiza as informações de configuração de um dado.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dado. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name | Valor texto com o nome do dado. |
description | Valor texto com a descrição do dado. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dado deve ser herdada do dispositivo. |
memory_type_id | Valor inteiro com o identificador do tipo de memória associado ao dado. |
memory_address | Valor inteiro com o endereço do dado. |
unity_label | Valor texto com a unidade de engenharia associado ao dado. |
value_format_type_id | Valor inteiro com identificador do tipo de formatação do valor do dado. |
update_value_mode_after_writing_id | Valor inteiro com identificador do modo de atualização do valor do dado após um comando de escrita. |
read_only | Valor booleano que indica se o dado é desomente leitura. |
enabled | Valor booleano que indica se o dado está habilitado no sistema. |
history_enabled | Valor booleano que indica se o valor do dado de ser historiado pelo sistema. |
source_value_id | Valor inteiro com o identificador da fonte de coleta do valor do dado. |
local_storage_identity_number | Valor inteiro com o identificador da posição do dado no buffer da base local decoleta de dados. |
calculation_type_id | Valor inteiro com o identificador do tipo de cálculo associado ao dado. |
calculation_param_a | Valor texto associado ao primeiro parâmetro do tipo de cálculo. |
calculation_param_b | Valor texto associado ao segundo parâmetro do tipo de cálculo. |
calculation_param_c | Valor texto associado ao terceiro parâmetro do tipo de cálculo. |
calculation_param_d | Valor texto associado ao quarto parâmetro do tipo de cálculo. |
text_list_id | Valor inteiro com o identificador do da lista de texto associado ao dado. |
minimum_value | Valor real mínimo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
maximum_value | Valor real máximo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
data > delete
Remove um determinado dado da base de dados.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dado. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
data > clear_history > create
Remove os registros de históricos de um dado do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dado a serem removidos os registros do(s) histórico(s). |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
history_type required | Valor texto com o tipo do histórico a serem removidos os registros. Valor para cada tipo:
|
reason required | Valor texto com a descrição do motivo para remoção dos registros do(s) histórico(s). Este registro poderá ser consultado posteriormente no histórico de eventos do sistema. |
cutting_datetime | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de corte para remoção de registros do(s) histórico(s). Ou seja, todos os registros iguais ou anteriores a data/hora fornecida serão removidos. Caso não seja fornecido este parâmetro, todos os registros serão removidos do(s) histórico(s) para o recurso selecionado. |
data > duplicate > create
Duplica o cadastro de um dado no Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dado a ser duplicado. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do dado utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do dado. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do dado. |
description | Valor texto com a descrição do dado. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dado deve ser herdada do dispositivo. |
memory_type_id required | Valor inteiro com o identificador do tipo de memória associado ao dado. |
memory_address | Valor inteiro com o endereço do dado. |
unity_label | Valor texto com a unidade de engenharia associado ao dado. |
value_format_type_id | Valor inteiro com identificador do tipo de formatação do valor do dado. |
update_value_mode_after_writing_id | Valor inteiro com identificador do modo de atualização do valor do dado após um comando de escrita. |
read_only | Valor booleano que indica se o dado é desomente leitura. |
enabled | Valor booleano que indica se o dado está habilitado no sistema. |
history_enabled | Valor booleano que indica se o valor do dado de ser historiado pelo sistema. |
source_value_id required | Valor inteiro com o identificador da fonte de coleta do valor do dado. |
local_storage_identity_number | Valor inteiro com o identificador da posição do dado no buffer da base local decoleta de dados. |
calculation_type_id | Valor inteiro com o identificador do tipo de cálculo associado ao dado. |
calculation_param_a | Valor texto associado ao primeiro parâmetro do tipo de cálculo. |
calculation_param_b | Valor texto associado ao segundo parâmetro do tipo de cálculo. |
calculation_param_c | Valor texto associado ao terceiro parâmetro do tipo de cálculo. |
calculation_param_d | Valor texto associado ao quarto parâmetro do tipo de cálculo. |
text_list_id | Valor inteiro com o identificador do da lista de texto associado ao dado. |
minimum_value | Valor real mínimo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
maximum_value | Valor real máximo permitido para o dado(para que o portal possa validar a atualização/coleta do valor do dado) |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
data_current_value > list
Obtém o valor corrente de dados do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
connector_id | Valor inteiro com o identificador do conector associado ao dado do histórico. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado do histórico. |
data_id | Valor inteiro com o identificador do dado associado ao histórico. |
data_ids | Valores inteiros com os identificadores dos dados associados ao histórico. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado do histórico. |
contract_id | Valor inteiro com o identificador do contrato associado ao dado do histórico. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
data_history > list
Obtém a lista do histórico de valores dos dados do sistema. Caso não fornecido um período, serão retornados dados das ÚLTIMAS 24 HORAS. O período MÁXIMO para consulta no histórico é de 1 MÊS.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
connector_id | Valor inteiro com o identificador do conector associado ao dado do histórico. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado do histórico. |
data_id | Valor inteiro com o identificador do dado associado ao histórico. |
data_ids | Valores inteiros com os identificadores dos dados associados ao histórico. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado do histórico. |
contract_id | Valor inteiro com o identificador do contrato associado ao dado do histórico. |
start | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-01 08:00:00) de início para recuperação de registros no histórico. |
end | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de fim para recuperação de registros no histórico. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
devices > list
Obtém a lista de dispositivos.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
name | Texto com o nome do dispositivo. |
connector_id | Valor inteiro com o identificador do conector associado ao dispositivo. |
connector_name | Texto com o nome do conector associado ao dispositivo. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dispositivo. |
process_area_name | Texto com o nome da área de processo associada ao dispositivo. |
contract_id | Valor inteiro com o identificador do contrato associado ao dispositivo. |
enabled | Valor booleano de identificação do estado de habilitação do recurso no sistema. |
base_model | Valor booleano de identificação se o recurso é de modelo. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
devices > create
Cria um dispositivo.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do dispositivo. |
description | Valor texto com a descrição do dispositivo. |
connector_id required | Valor inteiro com o identificador do conector associado ao dispositivo. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dispositivo. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dispositivo deve ser herdada do conector. |
device_address required | Valor inteiro com o endereço do dispositivo |
is_hi_device | Valor booleano que indica se o dispositivo é de fabricação da HI Tecnologia. |
local_storage_enabled | Valor booleano que indica se a coleta de dados da base local está habilitada. |
local_storage_version_id | Valor inteiro com a identificação da versão da estrutura da base local de coleta de dados. |
local_storage_initial_address | Valor inteiro do endereço de início da base local de coleta de dados. |
local_storage_timezone | Valor texto com a identificação do timezone associado aos registros da base local de coleta de dados. |
portal_data | Objeto JSON com a definição de dados customizados pelo Portal de Telemetria. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
devices > read
Obtém os detalhes de configuração de um determinado dispositivo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dispositivo. |
devices > partial_update_0
Atualiza as informações de configuração de um dispositivo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dispositivo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name | Valor texto com o nome do dispositivo. |
description | Valor texto com a descrição do dispositivo. |
connector_id | Valor inteiro com o identificador do conector associado ao dispositivo. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dispositivo. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dispositivo deve ser herdada do conector. |
device_address | Valor inteiro com o endereço do dispositivo |
is_hi_device | Valor booleano que indica se o dispositivo é de fabricação da HI Tecnologia. |
local_storage_enabled | Valor booleano que indica se a coleta de dados da base local está habilitada. |
local_storage_version_id | Valor inteiro com a identificação da versão da estrutura da base local de coleta de dados. |
local_storage_initial_address | Valor inteiro do endereço de início da base local de coleta de dados. |
local_storage_timezone | Valor texto com a identificação do timezone associado aos registros da base local de coleta de dados. |
portal_data | Objeto JSON com a definição de dados customizados pelo Portal de Telemetria. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
devices > delete
Remove um determinado dispositivo da base de dados.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dispositivo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
devices > clear_history > create
Remove os registros de históricos de um dispositivo do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do dispositivo a serem removidos os registros do(s) histórico(s). |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
history_type required | Valor texto com o tipo do histórico a serem removidos os registros. Valor para cada tipo:
|
reason required | Valor texto com a descrição do motivo para remoção dos registros do(s) histórico(s). Este registro poderá ser consultado posteriormente no histórico de eventos do sistema. |
cutting_datetime | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de corte para remoção de registros do(s) histórico(s). Ou seja, todos os registros iguais ou anteriores a data/hora fornecida serão removidos. Caso não seja fornecido este parâmetro, todos os registros serão removidos do(s) histórico(s) para o recurso selecionado. |
devices > duplicate > create
Duplica o cadastro de um dispositivo no Portal de Telemetria.
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do dispositivo utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do dispositivo. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do dispositivo. |
description | Valor texto com a descrição do dispositivo. |
connector_id | Valor inteiro com o identificador do conector associado ao dispositivo. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dispositivo. |
inherits_parent_process_area | Valor booleano que indica se a área de processo associada ao dispositivo deve ser herdada do conector. |
device_address required | Valor inteiro com o endereço do dispositivo |
is_hi_device | Valor booleano que indica se o dispositivo é de fabricação da HI Tecnologia. |
local_storage_enabled | Valor booleano que indica se a coleta de dados da base local está habilitada. |
local_storage_version_id | Valor inteiro com a identificação da versão da estrutura da base local de coleta de dados. |
local_storage_initial_address | Valor inteiro do endereço de início da base local de coleta de dados. |
local_storage_timezone | Valor texto com a identificação do timezone associado aos registros da base local de coleta de dados. |
portal_data | Objeto JSON com a definição de dados customizados pelo Portal de Telemetria. |
user_data | Objeto JSON com a definição de dados customizados pelo usuário. |
machines > read
Obtém os detalhes de configuração de uma determinada área de processo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
machines > partial_update
Atualiza as informações de configuração de uma determinada área de processo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
identity_name | Valor texto com o nome da área de processo. |
description | Valor texto com a descrição da área de processo. |
contract_id | Valor inteiro com o identificador do contrato associado a área de processo. |
machines > delete
Remove uma determinada área de processo do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
process_areas > list
Obtém a lista de áreas de processo do Portal de Telemetria.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
contract_id | Valor inteiro com o identificador do contrato associado a área de processo. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
process_areas > create
Cria uma área de processo no Portal de Telemetria.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome da área de processo. |
description | Valor texto com a descrição da área de processo. |
contract_id required | Valor inteiro com o identificador do contrato associado a área de processo. |
process_areas > read
Obtém os detalhes de configuração de uma determinada área de processo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
process_areas > partial_update
Atualiza as informações de configuração de uma determinada área de processo.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
identity_name | Valor texto com o nome da área de processo. |
description | Valor texto com a descrição da área de processo. |
contract_id | Valor inteiro com o identificador do contrato associado a área de processo. |
process_areas > delete
Remove uma determinada área de processo do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da área de processo. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
remote_access_tokens > list
Obtém a lista de tokens para acesso remoto ao conector.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
connector_id | Valor inteiro com o identificador do conector associado ao token. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-token |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
remote_access_tokens > create
Cria um token para acesso remoto ao conector.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
remote_access_token_type_id required | Valor inteiro com o identificador do tipo de token. |
connector_id required | Valor inteiro com o identificador do conector associado ao token. |
enabled | Valor booleano que indica se o token está habilitado no sistema. |
remote_access_tokens > read
Obtém os detalhes de configuração de um determinado token.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do token. |
remote_access_tokens > partial_update
Atualiza as informações de configuração de um token.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do token. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
remote_access_token_type_id | Valor inteiro com o identificador do tipo de token. |
connector_id | Valor inteiro com o identificador do conector associado ao token. |
enabled | Valor booleano que indica se o token está habilitado no sistema. |
remote_access_tokens > delete
Remove um determinado token da base de dados.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do token. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
system_history > list
Obtém a lista do histórico de eventos do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
contract_id required | Valor inteiro com o identificador do contrato associado ao histórico. |
connector_id | Valor inteiro com o identificador do conector associado ao histórico. |
data_id | Valor inteiro com o identificador do dado associado ao histórico. |
system_event_id | Valor inteiro com o identificador do evento de sistema associado ao histórico. |
system_sub_event_id | Valor inteiro com o identificador do sub-evento de sistema associado ao histórico. |
start | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-01 08:00:00) de início para recuperação de registros no histórico. |
end | Valor texto com a definição de data/hora(no formato ISO8601, exemplo: 2020-12-31 23:59:59) de fim para recuperação de registros no histórico. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-data_name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
tags > list
Obtém o valor corrente de dados do sistema.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
connector_id | Valor inteiro com o identificador do conector associado ao dado do histórico. |
device_id | Valor inteiro com o identificador do dispositivo associado ao dado do histórico. |
data_id | Valor inteiro com o identificador do dado associado ao histórico. |
data_ids | Valores inteiros com os identificadores dos dados associados ao histórico. |
process_area_id | Valor inteiro com o identificador da área de processo associada ao dado do histórico. |
contract_id | Valor inteiro com o identificador do contrato associado ao dado do histórico. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
text_lists > list
Obtém as listas de textos do Portal de Telemetria.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
contract_id | Valor inteiro com o identificador do contrato associado a lista de texto. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
text_lists > create
Cria uma lista de texto no Portal de Telemetria.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome da lista de texto. |
description | Valor texto com a descrição da lista detexto. |
contract_id required | Valor inteiro com o identificador do contrato associado a lista de texto. |
default_item | Objeto JSON com a definição do item padrão da lista de texto. |
items required | Objeto JSON com a definição dos itens da lista de texto. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
text_lists > read
Obtém os detalhes de configuração de uma determinada lista de texto.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da lista de texto. |
text_lists > partial_update
Atualiza as informações de configuração de uma determinada lista de texto.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da lista de texto. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name | Valor texto com o nome da lista de texto. |
description | Valor texto com a descrição da lista detexto. |
contract_id | Valor inteiro com o identificador do contrato associado a lista de texto. |
default_item | Objeto JSON com a definição do item padrão da lista de texto. |
items | Objeto JSON com a definição dos itens da lista de texto. |
portal_data | Objeto JSON com a definição de dados customizados pelo sistema. |
text_lists > delete
Remove uma determinada lista de texto do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador da lista de texto. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
user_groups > list
Obtém a lista de grupos de usuários do Portal de Telemetria.
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
contract_id | Valor inteiro com o identificador do contrato associado ao grupo de usuários. |
ordering | Valor texto que define quais campos do recurso(separados por ",") devem ser utilizados para ordenação da coleção. Campos possíveis:
/ordering=-name |
page_size | Valor inteiro com o número máximo de registros que devem ser retornados na coleção(tamanho da página). |
page | Valor inteiro com o número da página a serem retornados na coleção. Deve ser utilizado em conjunto com "page". |
limit | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
offset | Valor inteiro com o deslocamento de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "offset". |
max_results | Valor inteiro com o número máximo de registros que devem ser retornados na coleção. |
page_token | Valor texto com a identificação da página de registros a serem retornados na coleção. Deve ser utilizado em conjunto com "max_results". |
user_groups > create
Cria um grupo de usuários no Portal de Telemetria.
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
name required | Valor texto com o nome do grupo de usuário. |
description | Valor texto com a descrição do grupo de usuário. |
contract_id required | Valor inteiro com o identificador do contrato associado ao grupo de usuário. |
portal_permissions_ids | Lista com os valores inteiros de identificação das permissões do portal associadas ao grupo de usuários. |
user_groups > read
Obtém os detalhes de configuração de um determinado grupo de usuário.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do grupo de usuário. |
user_groups > partial_update
Atualiza as informações de configuração de um determinado grupo de usuário.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do grupo de usuário. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |
Request Body
The request body should be "application/json"
encoded, and should contain a single item.
Parameter | Description |
---|---|
identity_name | Valor texto com o nome do grupo de usuário |
description | Valor texto com a descrição do grupo de usuário |
contract_id | Valor inteiro com o identificador do contrato associado ao grupo de usuário. |
portal_permissions_ids | Lista com os valores inteiros de identificação das permissões do portal associadas ao grupo de usuários. |
user_groups > delete
Remove uma determinado grupo de usuário do Portal de Telemetria.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | Valor inteiro com o identificador do grupo de usuário. |
Header Parameters
The following parameters should be included as HTTP headers.
Parameter | Description |
---|---|
If-Match required | Valor do ETAG de representação do recurso utilizado na operação. O valor do ETAG pode ser obtido na requisição via GET do recurso. |