termo_core 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,7 +4,7 @@ import { TERMO_TRACING as SERVICO_DESTA_API } from "../base/servicos.js";
4
4
  /**
5
5
  * Lista os aplicativos paginados
6
6
  *
7
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os aplicativos não excluídos da conta em ordem alfabética do nome. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
7
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os aplicativos em ordem alfabética do nome. Os aplicativos vêm do TermoAuth: quando quem chama é master do TermoAuth, a lista é sincronizada antes da resposta (app novo ganha uma `chave` e app que saiu do TermoAuth some daqui); nome, setor e domínios não se alteram por aqui. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
8
8
  *
9
9
  * `GET /aplicativo`
10
10
  */
@@ -18,27 +18,10 @@ export function buscar_paginador_aplicativo(credencial_de_acesso, parametros = {
18
18
  formato_da_resposta: "json",
19
19
  }, opcoes_da_chamada);
20
20
  }
21
- /**
22
- * Cadastra um aplicativo
23
- *
24
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Cadastra um site ou sistema que vai enviar eventos ao TermoTracing. `nome` é obrigatório. `dominios` precisa ter ao menos um domínio válido (host com ponto, `localhost` ou curinga `*.dominio.com`, porta opcional); `https://`, caminho e ponto final são removidos. `franquia_mensal` (eventos por ciclo mensal) tem padrão 100000 e precisa ser maior que zero. `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` (padrão) ou `PARAR_INGESTAO`. O backend gera a `chave` pública (prefixo `pk_live_`) que o script do site usa na ingestão; ela não é segredo, porque a ingestão só aceita os domínios cadastrados. Campos do corpo: `nome`: nome do aplicativo (obrigatório, não pode ficar vazio); `dominios`: domínios autorizados a enviar eventos; precisa de ao menos um válido (host com ponto, `localhost` ou `*.dominio.com`, porta opcional). `https://`, caminho e ponto final são removidos; `franquia_mensal`: eventos incluídos por ciclo mensal, maior que zero (padrão 100000); `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` (padrão) segue recebendo e conta o excedente; `PARAR_INGESTAO` recusa os lotes depois da franquia.
25
- *
26
- * `POST /aplicativo`
27
- */
28
- export function criar_aplicativo(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
29
- return chamar_servico({
30
- servico: SERVICO_DESTA_API,
31
- metodo_http: "POST",
32
- caminho_da_rota: "/aplicativo",
33
- credencial_de_acesso,
34
- corpo_json: corpo_da_requisicao,
35
- formato_da_resposta: "json",
36
- }, opcoes_da_chamada);
37
- }
38
21
  /**
39
22
  * Lista básica de aplicativos para seleção
40
23
  *
41
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id, nome e chave dos aplicativos não excluídos da conta, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
24
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id, nome e chave dos aplicativos não excluídos, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
42
25
  *
43
26
  * `GET /aplicativo/autocomplete`
44
27
  */
@@ -55,7 +38,7 @@ export function buscar_auto_complete_aplicativo(credencial_de_acesso, parametros
55
38
  /**
56
39
  * Busca aplicativos por filtro
57
40
  *
58
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os aplicativos não excluídos da conta que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
41
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os aplicativos não excluídos que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
59
42
  *
60
43
  * `GET /aplicativo/filtro`
61
44
  */
@@ -72,7 +55,7 @@ export function buscar_pelo_filtro_aplicativo(credencial_de_acesso, parametros =
72
55
  /**
73
56
  * Busca um aplicativo pelo id
74
57
  *
75
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o aplicativo pelo id; registro excluído não é encontrado.
58
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o aplicativo pelo id; registro excluído não é encontrado.
76
59
  *
77
60
  * `GET /aplicativo/{id}`
78
61
  */
@@ -85,43 +68,10 @@ export function buscar_pelo_id_aplicativo(credencial_de_acesso, id, opcoes_da_ch
85
68
  formato_da_resposta: "json",
86
69
  }, opcoes_da_chamada);
87
70
  }
88
- /**
89
- * Atualiza um aplicativo pelo id
90
- *
91
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. `nome` não pode ficar vazio; `dominios` substitui a lista inteira e precisa de ao menos um domínio válido; `franquia_mensal` precisa ser maior que zero; `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`. Com `rotacionar_chave: true` o backend gera uma `chave` nova e a antiga para de valer na ingestão. Campos do corpo, todos opcionais: `nome`: novo nome (não pode ficar vazio); `dominios`: nova lista de domínios, que substitui a atual; precisa de ao menos um válido; `franquia_mensal`: nova franquia mensal de eventos, maior que zero; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`; `rotacionar_chave`: com `true`, gera uma chave nova e a antiga para de valer na ingestão.
92
- *
93
- * `PATCH /aplicativo/{id}`
94
- */
95
- export function atualizar_pelo_id_aplicativo(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
96
- return chamar_servico({
97
- servico: SERVICO_DESTA_API,
98
- metodo_http: "PATCH",
99
- caminho_da_rota: `/aplicativo/${codificar_parametro_de_caminho(id)}`,
100
- credencial_de_acesso,
101
- corpo_json: corpo_da_requisicao,
102
- formato_da_resposta: "json",
103
- }, opcoes_da_chamada);
104
- }
105
- /**
106
- * Exclui um aplicativo pelo id
107
- *
108
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o aplicativo some das leituras e a chave dele deixa de ser aceita na ingestão.
109
- *
110
- * `DELETE /aplicativo/{id}`
111
- */
112
- export function deletar_pelo_id_aplicativo(credencial_de_acesso, id, opcoes_da_chamada) {
113
- return chamar_servico({
114
- servico: SERVICO_DESTA_API,
115
- metodo_http: "DELETE",
116
- caminho_da_rota: `/aplicativo/${codificar_parametro_de_caminho(id)}`,
117
- credencial_de_acesso,
118
- formato_da_resposta: "sem_conteudo",
119
- }, opcoes_da_chamada);
120
- }
121
71
  /**
122
72
  * Lista os erros paginados
123
73
  *
124
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os grupos de erro não excluídos da conta, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
74
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os grupos de erro não excluídos, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
125
75
  *
126
76
  * `GET /erro`
127
77
  */
@@ -138,7 +88,7 @@ export function buscar_paginador_erro(credencial_de_acesso, parametros = {}, opc
138
88
  /**
139
89
  * Cadastra um erro
140
90
  *
141
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Registra a ocorrência de um erro num aplicativo da conta (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
91
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Registra a ocorrência de um erro num aplicativo (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
142
92
  *
143
93
  * `POST /erro`
144
94
  */
@@ -155,7 +105,7 @@ export function criar_erro(credencial_de_acesso, corpo_da_requisicao, opcoes_da_
155
105
  /**
156
106
  * Lista básica de erros para seleção
157
107
  *
158
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
108
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
159
109
  *
160
110
  * `GET /erro/autocomplete`
161
111
  */
@@ -172,7 +122,7 @@ export function buscar_auto_complete_erro(credencial_de_acesso, parametros = {},
172
122
  /**
173
123
  * Busca erros por filtro
174
124
  *
175
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os grupos de erro não excluídos da conta que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
125
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os grupos de erro não excluídos que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
176
126
  *
177
127
  * `GET /erro/filtro`
178
128
  */
@@ -189,7 +139,7 @@ export function buscar_pelo_filtro_erro(credencial_de_acesso, parametros = {}, o
189
139
  /**
190
140
  * Busca um erro pelo id
191
141
  *
192
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o erro pelo id; registro excluído não é encontrado.
142
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o erro pelo id; registro excluído não é encontrado.
193
143
  *
194
144
  * `GET /erro/{id}`
195
145
  */
@@ -205,7 +155,7 @@ export function buscar_pelo_id_erro(credencial_de_acesso, id, opcoes_da_chamada)
205
155
  /**
206
156
  * Atualiza um erro pelo id
207
157
  *
208
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
158
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
209
159
  *
210
160
  * `PATCH /erro/{id}`
211
161
  */
@@ -222,7 +172,7 @@ export function atualizar_pelo_id_erro(credencial_de_acesso, id, corpo_da_requis
222
172
  /**
223
173
  * Exclui um erro pelo id
224
174
  *
225
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
175
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
226
176
  *
227
177
  * `DELETE /erro/{id}`
228
178
  */
@@ -238,7 +188,7 @@ export function deletar_pelo_id_erro(credencial_de_acesso, id, opcoes_da_chamada
238
188
  /**
239
189
  * Lista os eventos paginados
240
190
  *
241
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os eventos não excluídos da conta. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
191
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os eventos não excluídos. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
242
192
  *
243
193
  * `GET /evento`
244
194
  */
@@ -255,7 +205,7 @@ export function buscar_paginador_evento(credencial_de_acesso, parametros = {}, o
255
205
  /**
256
206
  * Lista básica de eventos para seleção
257
207
  *
258
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
208
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
259
209
  *
260
210
  * `GET /evento/autocomplete`
261
211
  */
@@ -272,7 +222,7 @@ export function buscar_auto_complete_evento(credencial_de_acesso, parametros = {
272
222
  /**
273
223
  * Busca eventos por filtro
274
224
  *
275
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os eventos não excluídos da conta que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
225
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os eventos não excluídos que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
276
226
  *
277
227
  * `GET /evento/filtro`
278
228
  */
@@ -289,7 +239,7 @@ export function buscar_pelo_filtro_evento(credencial_de_acesso, parametros = {},
289
239
  /**
290
240
  * Busca um evento pelo id
291
241
  *
292
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o evento pelo id; registro excluído não é encontrado.
242
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o evento pelo id; registro excluído não é encontrado.
293
243
  *
294
244
  * `GET /evento/{id}`
295
245
  */
@@ -305,7 +255,7 @@ export function buscar_pelo_id_evento(credencial_de_acesso, id, opcoes_da_chamad
305
255
  /**
306
256
  * Atualiza um evento pelo id
307
257
  *
308
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
258
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
309
259
  *
310
260
  * `PATCH /evento/{id}`
311
261
  */
@@ -322,7 +272,7 @@ export function atualizar_pelo_id_evento(credencial_de_acesso, id, corpo_da_requ
322
272
  /**
323
273
  * Exclui um evento pelo id
324
274
  *
325
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
275
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
326
276
  *
327
277
  * `DELETE /evento/{id}`
328
278
  */
@@ -338,7 +288,7 @@ export function deletar_pelo_id_evento(credencial_de_acesso, id, opcoes_da_chama
338
288
  /**
339
289
  * Lista as sessões paginadas
340
290
  *
341
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista as sessões não excluídas da conta, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
291
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista as sessões não excluídas, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
342
292
  *
343
293
  * `GET /sessao`
344
294
  */
@@ -355,7 +305,7 @@ export function buscar_paginador_sessao(credencial_de_acesso, parametros = {}, o
355
305
  /**
356
306
  * Cadastra uma sessão
357
307
  *
358
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Grava uma sessão de navegação de um aplicativo da conta (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
308
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Grava uma sessão de navegação de um aplicativo (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
359
309
  *
360
310
  * `POST /sessao`
361
311
  */
@@ -372,7 +322,7 @@ export function criar_sessao(credencial_de_acesso, corpo_da_requisicao, opcoes_d
372
322
  /**
373
323
  * Lista básica de sessões para seleção
374
324
  *
375
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
325
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
376
326
  *
377
327
  * `GET /sessao/autocomplete`
378
328
  */
@@ -389,7 +339,7 @@ export function buscar_auto_complete_sessao(credencial_de_acesso, parametros = {
389
339
  /**
390
340
  * Busca sessões por filtro
391
341
  *
392
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todas as sessões não excluídas da conta que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
342
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todas as sessões não excluídas que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
393
343
  *
394
344
  * `GET /sessao/filtro`
395
345
  */
@@ -406,7 +356,7 @@ export function buscar_pelo_filtro_sessao(credencial_de_acesso, parametros = {},
406
356
  /**
407
357
  * Busca uma sessão pelo id
408
358
  *
409
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve a sessão pelo id; registro excluído não é encontrado.
359
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve a sessão pelo id; registro excluído não é encontrado.
410
360
  *
411
361
  * `GET /sessao/{id}`
412
362
  */
@@ -422,7 +372,7 @@ export function buscar_pelo_id_sessao(credencial_de_acesso, id, opcoes_da_chamad
422
372
  /**
423
373
  * Atualiza uma sessão pelo id
424
374
  *
425
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
375
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
426
376
  *
427
377
  * `PATCH /sessao/{id}`
428
378
  */
@@ -439,7 +389,7 @@ export function atualizar_pelo_id_sessao(credencial_de_acesso, id, corpo_da_requ
439
389
  /**
440
390
  * Exclui uma sessão pelo id
441
391
  *
442
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
392
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
443
393
  *
444
394
  * `DELETE /sessao/{id}`
445
395
  */
@@ -455,7 +405,7 @@ export function deletar_pelo_id_sessao(credencial_de_acesso, id, opcoes_da_chama
455
405
  /**
456
406
  * Lista os registros de uso paginados
457
407
  *
458
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os registros de uso diário não excluídos da conta, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
408
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os registros de uso diário não excluídos, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
459
409
  *
460
410
  * `GET /uso`
461
411
  */
@@ -472,7 +422,7 @@ export function buscar_paginador_uso(credencial_de_acesso, parametros = {}, opco
472
422
  /**
473
423
  * Cadastra um registro de uso
474
424
  *
475
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Soma eventos aceitos e recusados ao uso diário de um aplicativo da conta (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
425
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Soma eventos aceitos e recusados ao uso diário de um aplicativo (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
476
426
  *
477
427
  * `POST /uso`
478
428
  */
@@ -489,7 +439,7 @@ export function criar_uso(credencial_de_acesso, corpo_da_requisicao, opcoes_da_c
489
439
  /**
490
440
  * Lista básica de registros de uso para seleção
491
441
  *
492
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
442
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
493
443
  *
494
444
  * `GET /uso/autocomplete`
495
445
  */
@@ -506,7 +456,7 @@ export function buscar_auto_complete_uso(credencial_de_acesso, parametros = {},
506
456
  /**
507
457
  * Busca registros de uso por filtro
508
458
  *
509
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os registros de uso diário não excluídos da conta que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
459
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os registros de uso diário não excluídos que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
510
460
  *
511
461
  * `GET /uso/filtro`
512
462
  */
@@ -523,7 +473,7 @@ export function buscar_pelo_filtro_uso(credencial_de_acesso, parametros = {}, op
523
473
  /**
524
474
  * Busca um registro de uso pelo id
525
475
  *
526
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o registro de uso pelo id; registro excluído não é encontrado.
476
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o registro de uso pelo id; registro excluído não é encontrado.
527
477
  *
528
478
  * `GET /uso/{id}`
529
479
  */
@@ -539,7 +489,7 @@ export function buscar_pelo_id_uso(credencial_de_acesso, id, opcoes_da_chamada)
539
489
  /**
540
490
  * Atualiza um registro de uso pelo id
541
491
  *
542
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
492
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
543
493
  *
544
494
  * `PATCH /uso/{id}`
545
495
  */
@@ -556,7 +506,7 @@ export function atualizar_pelo_id_uso(credencial_de_acesso, id, corpo_da_requisi
556
506
  /**
557
507
  * Exclui um registro de uso pelo id
558
508
  *
559
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
509
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
560
510
  *
561
511
  * `DELETE /uso/{id}`
562
512
  */
@@ -10,25 +10,14 @@ export interface Aplicativo {
10
10
  id: string;
11
11
  nome: string;
12
12
  primeiro_evento_em?: string | null;
13
- }
14
- export interface AplicativoAtualizar {
15
- comportamento_ao_estourar?: string | null;
16
- dominios?: Array<string> | null;
17
- franquia_mensal?: number | null;
18
- nome?: string | null;
19
- rotacionar_chave?: boolean | null;
13
+ setor: string;
14
+ termoauth_id?: string | null;
20
15
  }
21
16
  export interface AplicativoAutoComplete {
22
17
  chave: string;
23
18
  id: string;
24
19
  nome: string;
25
20
  }
26
- export interface AplicativoCriar {
27
- comportamento_ao_estourar?: string;
28
- dominios?: Array<string>;
29
- franquia_mensal?: number;
30
- nome: string;
31
- }
32
21
  export interface Erro {
33
22
  aplicativo_id: string;
34
23
  arquivo?: string | null;
@@ -109,6 +98,8 @@ export interface PaginaAplicativoItensItem {
109
98
  id: string;
110
99
  nome: string;
111
100
  primeiro_evento_em?: string | null;
101
+ setor: string;
102
+ termoauth_id?: string | null;
112
103
  }
113
104
  export interface PaginaAplicativo {
114
105
  itens: Array<PaginaAplicativoItensItem>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "termo_core",
3
- "version": "0.1.5",
3
+ "version": "0.1.7",
4
4
  "description": "Todos os clientes da Termotubos num pacote só: um módulo por serviço e cada rota da API como uma função com fetch, com o endereço resolvido pelo ambiente atual.",
5
5
  "license": "MIT",
6
6
  "author": "TI Termotubos <ti@termotubos.com.br>",