Auth

// npm install termo_core --save-exact
import * as webhook from "termo_core/webhook";
// ou: import { webhook } from "termo_core";

Função	Rota	O que faz
`buscar_paginador_auth`	`GET /auth`	Lista acessos com paginação
`criar_auth`	`POST /auth`	Cria um acesso
`buscar_acesso_auth`	`GET /auth/acesso`	Busca o acesso de quem está logado
`buscar_auto_complete_auth`	`GET /auth/autocomplete`	Lista básica de acessos para seleção
`buscar_pelo_filtro_auth`	`GET /auth/filtro`	Busca acessos por filtro
`buscar_pelo_id_auth`	`GET /auth/{id}`	Busca um acesso pelo id
`atualizar_pelo_id_auth`	`PATCH /auth/{id}`	Atualiza um acesso pelo id
`deletar_pelo_id_auth`	`DELETE /auth/{id}`	Exclui um acesso pelo id

`buscar_paginador_auth`

GET/auth Exige credencial

Lista acessos com paginação

Exige qualquer permissão da área colaboradores. Ordena por perfil e depois por e-mail. pagina começa em 1 (padrão 1); tamanho tem padrão 10, sem máximo. Acessos excluídos não aparecem nem entram no total.

function buscar_paginador_auth(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPaginadorAuth = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaAuth>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { buscar_paginador_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_paginador_auth(credencial_de_acesso, { pagina: 1 });

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PaginaAuth> · Rust: Result<tipos::PaginaAuth, ErroAoChamarServico> · veja PaginaAuth.

`criar_auth`

POST/auth Exige credencial

Cria um acesso

Exige a permissão criar da área colaboradores. Cadastra quem pode entrar no TermoWebhook: o e-mail é gravado em minúsculas, sem espaços nas pontas, com até 160 caracteres. O único perfil aceito é colaborador. O acesso nasce ativo e sem perfil de acesso. Para a pessoa conseguir entrar, o e-mail precisa ser @termotubos.com.br e existir no TermoAuth. O colaborador (nome, setor, cargo e função) não se cadastra aqui: vem só do TermoAuth, pelos eventos do TermoWebhook.

function criar_auth(
  credencial_de_acesso: CredencialDeAcesso,
  corpo_da_requisicao: tipos.AuthCriar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Auth>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { criar_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await criar_auth(credencial_de_acesso, corpo_da_requisicao);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.Auth> · Rust: Result<tipos::Auth, ErroAoChamarServico> · veja Auth.

`buscar_acesso_auth`

GET/auth/acesso Exige credencial

Busca o acesso de quem está logado

Livre para qualquer usuário autenticado com cadastro ativo, mesmo sem nenhuma permissão liberada. Devolve o cadastro de quem chamou, o nome do perfil de acesso do colaborador em perfil_acesso (null quando ainda não tem) e as permissões que o perfil dá por área (monitoramento, aplicativos, contratos, assinaturas e colaboradores), cada uma com ler, criar, editar e deletar. Um master do TermoAuth recebe todas as permissões e, no primeiro acesso, ganha o cadastro automaticamente. nome vem do TermoAuth e, se estiver vazio, repete o e-mail. É a chamada que o painel faz antes de mostrar qualquer tela.

function buscar_acesso_auth(
  credencial_de_acesso: CredencialDeAcesso,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.AcessoAtual>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { buscar_acesso_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_acesso_auth(credencial_de_acesso);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.AcessoAtual> · Rust: Result<tipos::AcessoAtual, ErroAoChamarServico> · veja AcessoAtual.

`buscar_auto_complete_auth`

GET/auth/autocomplete Exige credencial

Lista básica de acessos para seleção

Exige qualquer permissão da área colaboradores. Devolve só id, e-mail e perfil, em ordem alfabética de e-mail, para escolher um acesso. busca procura por trecho do e-mail, sem diferenciar maiúsculas; perfil compara o valor exato. pagina começa em 1 (padrão 1); tamanho tem padrão 10, sem máximo.

function buscar_auto_complete_auth(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarAutoCompleteAuth = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.PaginaAuthAutoComplete>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { buscar_auto_complete_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_auto_complete_auth(credencial_de_acesso, { busca: "..." });

Argumentos

Nome

Tipo

Retorno: Promise<tipos.PaginaAuthAutoComplete> · Rust: Result<tipos::PaginaAuthAutoComplete, ErroAoChamarServico> · veja PaginaAuthAutoComplete.

`buscar_pelo_filtro_auth`

GET/auth/filtro Exige credencial

Busca acessos por filtro

Exige qualquer permissão da área colaboradores. Devolve todos os acessos que casam com o filtro, sem paginação, em ordem alfabética de e-mail. email procura por trecho, sem diferenciar maiúsculas; perfil compara o valor exato; ativo filtra pela situação. Sem filtro, devolve todos. Acessos excluídos não aparecem.

function buscar_pelo_filtro_auth(
  credencial_de_acesso: CredencialDeAcesso,
  parametros: ParametrosDeBuscarPeloFiltroAuth = {},
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<Array<tipos.Auth>>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_filtro_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_filtro_auth(credencial_de_acesso, { email: "..." });

Argumentos

Nome

Tipo

Retorno: Promise<Array<tipos.Auth>> · Rust: Result<Vec<tipos::Auth>, ErroAoChamarServico>

`buscar_pelo_id_auth`

GET/auth/{id} Exige credencial

Busca um acesso pelo id

Exige qualquer permissão da área colaboradores. Acesso excluído responde 404. vinculado diz se há um colaborador ligado ao acesso, e nome é o nome desse colaborador.

function buscar_pelo_id_auth(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Auth>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { buscar_pelo_id_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await buscar_pelo_id_auth(credencial_de_acesso, id);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.Auth> · Rust: Result<tipos::Auth, ErroAoChamarServico> · veja Auth.

`atualizar_pelo_id_auth`

PATCH/auth/{id} Exige credencial

Atualiza um acesso pelo id

Exige a permissão editar da área colaboradores. Só os campos enviados mudam: email (gravado em minúsculas, até 160 caracteres) e ativo (acesso inativo é barrado em todas as rotas). O acesso de um master do TermoAuth não pode ser alterado.

function atualizar_pelo_id_auth(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  corpo_da_requisicao: tipos.AuthAtualizar,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.Auth>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { atualizar_pelo_id_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
const resposta = await atualizar_pelo_id_auth(credencial_de_acesso, id, corpo_da_requisicao);

Argumentos

Nome

Tipo

Retorno: Promise<tipos.Auth> · Rust: Result<tipos::Auth, ErroAoChamarServico> · veja Auth.

`deletar_pelo_id_auth`

DELETE/auth/{id} Exige credencial

Exclui um acesso pelo id

Exige a permissão deletar da área colaboradores. A exclusão é lógica: o acesso some das consultas e a pessoa deixa de entrar, mas o registro fica guardado e não há como restaurar. Acesso com colaborador vinculado não pode ser excluído: o colaborador pertence ao TermoAuth e só sai de lá. O acesso de um master do TermoAuth não pode ser excluído.

function deletar_pelo_id_auth(
  credencial_de_acesso: CredencialDeAcesso,
  id: string,
  opcoes_da_chamada?: OpcoesDaChamada,
): Promise<void>

Exemplo

import { CredencialDeAcesso } from "termo_core";
import { deletar_pelo_id_auth } from "termo_core/webhook";

const credencial_de_acesso = CredencialDeAcesso.token_do_usuario_logado(token_do_usuario);
await deletar_pelo_id_auth(credencial_de_acesso, id);

Argumentos

Nome

Tipo

Retorno: Promise<void> · Rust: Result<(), ErroAoChamarServico> · sem corpo na resposta.

Tipos

Tipos usados pelas funções desta página. O nome é o mesmo nos dois pacotes.

AcessoAtual

import type { AcessoAtual } from "termo_core/webhook";

export interface AcessoAtual {
  email: string;
  id: string;
  master: boolean;
  nome: string;
  perfil: string;
  perfil_acesso?: string | null;
  permissoes: Permissoes;
}

Acoes

import type { Acoes } from "termo_core/webhook";

export interface Acoes {
  criar?: boolean;
  deletar?: boolean;
  editar?: boolean;
  ler?: boolean;
}

import type { Auth } from "termo_core/webhook";

export interface Auth {
  ativo: boolean;
  atualizado_em: string;
  bloqueado_ate?: string | null;
  criado_em: string;
  email: string;
  id: string;
  master: boolean;
  nome?: string | null;
  perfil: string;
  termoauth_id?: string | null;
  ultimo_login_em?: string | null;
  vinculado: boolean;
}

AuthAtualizar

import type { AuthAtualizar } from "termo_core/webhook";

export interface AuthAtualizar {
  ativo?: boolean | null;
  email?: string | null;
}

AuthCriar

import type { AuthCriar } from "termo_core/webhook";

export interface AuthCriar {
  email: string;
  perfil: string;
}

PaginaAuth

import type { PaginaAuth } from "termo_core/webhook";

export interface PaginaAuth {
  itens: Array<PaginaAuthItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaAuthAutoComplete

import type { PaginaAuthAutoComplete } from "termo_core/webhook";

export interface PaginaAuthAutoComplete {
  itens: Array<PaginaAuthAutoCompleteItensItem>;
  pagina: number;
  tamanho: number;
  total: number;
}

PaginaAuthAutoCompleteItensItem

import type { PaginaAuthAutoCompleteItensItem } from "termo_core/webhook";

export interface PaginaAuthAutoCompleteItensItem {
  email: string;
  id: string;
  perfil: string;
}

PaginaAuthItensItem

import type { PaginaAuthItensItem } from "termo_core/webhook";

export interface PaginaAuthItensItem {
  ativo: boolean;
  atualizado_em: string;
  bloqueado_ate?: string | null;
  criado_em: string;
  email: string;
  id: string;
  master: boolean;
  nome?: string | null;
  perfil: string;
  termoauth_id?: string | null;
  ultimo_login_em?: string | null;
  vinculado: boolean;
}

Permissoes

import type { Permissoes } from "termo_core/webhook";

export interface Permissoes {
  aplicativos?: Acoes;
  assinaturas?: Acoes;
  colaboradores?: Acoes;
  contratos?: Acoes;
  monitoramento?: Acoes;
}

Auth

buscar_paginador_authCopiar link

criar_authCopiar link

buscar_acesso_authCopiar link

buscar_auto_complete_authCopiar link

buscar_pelo_filtro_authCopiar link

buscar_pelo_id_authCopiar link

atualizar_pelo_id_authCopiar link

deletar_pelo_id_authCopiar link

TiposCopiar link

AcessoAtualCopiar link

AcoesCopiar link

AuthCopiar link

AuthAtualizarCopiar link

AuthCriarCopiar link

PaginaAuthCopiar link

PaginaAuthAutoCompleteCopiar link

PaginaAuthAutoCompleteItensItemCopiar link

PaginaAuthItensItemCopiar link

PermissoesCopiar link

Nesta página

`buscar_paginador_auth`

`criar_auth`

`buscar_acesso_auth`

`buscar_auto_complete_auth`

`buscar_pelo_filtro_auth`

`buscar_pelo_id_auth`

`atualizar_pelo_id_auth`

`deletar_pelo_id_auth`

Tipos

AcessoAtual

Acoes

Auth

AuthAtualizar

AuthCriar

PaginaAuth

PaginaAuthAutoComplete

PaginaAuthAutoCompleteItensItem

PaginaAuthItensItem

Permissoes