// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
use crate::base::servicos::TERMO_AUTH as SERVICO_DESTA_API;
#[allow(unused_imports)]
use crate::base::{
codificar_parametro_de_caminho, multipart, CredencialDeAcesso, ErroAoChamarServico, Method,
RequisicaoAoServico,
};
use serde::{Deserialize, Serialize};
#[allow(unused_imports)]
use super::tipos;
#[doc = "Parâmetros de consulta e de cabeçalho de `/app`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorApp {
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub setor: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub acesso: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub todos: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/app/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteApp {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/app/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroApp {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub setor: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub acesso: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/app/{id}`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloIdApp {
#[serde(skip_serializing_if = "Option::is_none")]
pub todos: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/cargo`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorCargo {
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/cargo/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteCargo {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/cargo/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroCargo {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/funcao`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorFuncao {
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/funcao/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteFuncao {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/funcao/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroFuncao {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/setor`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorSetor {
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/setor/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteSetor {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/setor/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroSetor {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/usuario`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorUsuario {
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub perfil: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub setor_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub cargo_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub funcao_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub acesso: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub dois_fatores: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub master: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub desativado: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/usuario/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteUsuario {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub perfil: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub pagina: Option<i64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tamanho: Option<i64>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/usuario/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroUsuario {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub perfil: Option<String>,
}
#[doc = "Lista apps com paginação\n\nNa ordem de exibição. Sem `todos`, devolve só os apps que o perfil de quem chama pode abrir e que aparecem na lista do ambiente atual, como o `/apps`. Com `todos=true`, que exige o token de um master, devolve todos os cadastrados, como o `/master/apps`. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 50 e máximo 500. `busca` procura no nome, no id e no setor. Os links rápidos (`endereco_repositorio`, `endereco_diagrama_banco`, `endereco_documentacao`, `endereco_openapi`) só vêm preenchidos para master.\n\n`GET /app`"]
pub async fn buscar_paginador_app(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorApp,
) -> Result<tipos::PaginaApp, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/app")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra um app\n\nSó master. `id` é o slug usado em `?app=<id>`: letras minúsculas, números e hífens, até 40 caracteres, e não pode ser `settings`. `perfis` lista quem pode abrir o app (`colaborador`, `cliente`, pelo menos um); `acesso` é `autenticado`, `em_hospedagem`, `em_desenvolvimento` ou `link_externo`. `cor` no formato `#rrggbb`; endereços começam com `http://` ou `https://`; `caminho_inicial` começa com `/`. `endereco_repositorio`, `endereco_diagrama_banco`, `endereco_documentacao` e `endereco_openapi` são os links rápidos da TI, opcionais. Cadastrar o id de um app excluído o traz de volta. Vale na hora, sem reiniciar nada.\n\n`POST /app`"]
pub async fn criar_app(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::AppCriar,
) -> Result<tipos::App, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/app")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de apps para seleção\n\nSó master. Devolve só id, nome e setor, em ordem alfabética, para escolher um app. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10. `busca` procura no nome e no id.\n\n`GET /app/autocomplete`"]
pub async fn buscar_auto_complete_app(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteApp,
) -> Result<tipos::PaginaAppAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/app/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca apps por filtro\n\nSó master. Devolve todos os apps que casam com o filtro, sem paginação, na ordem de exibição. `busca` procura no nome, no id e na descrição; `setor` compara sem diferenciar maiúsculas; `acesso` é `autenticado`, `em_hospedagem`, `em_desenvolvimento` ou `link_externo`.\n\n`GET /app/filtro`"]
pub async fn buscar_pelo_filtro_app(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroApp,
) -> Result<Vec<tipos::App>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/app/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um app pelo id\n\nSem token, só encontra os apps que têm porta de entrada no ambiente atual (`acesso` `autenticado` e endereço configurado). Com `todos=true`, que exige o token de um master, encontra qualquer app cadastrado. Os links rápidos (`endereco_repositorio`, `endereco_diagrama_banco`, `endereco_documentacao`, `endereco_openapi`) só vêm preenchidos com `todos=true`.\n\n`GET /app/{id}`"]
pub async fn buscar_pelo_id_app(
credencial_de_acesso: &CredencialDeAcesso,
id: &str,
parametros: &ParametrosDeBuscarPeloIdApp,
) -> Result<tipos::App, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/app/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza um app pelo id\n\nSó master. Atualização parcial: só os campos enviados mudam, e o `id` não muda. As regras de cada campo são as mesmas do cadastro. O app `settings` não pode ser alterado. Vale na hora, sem reiniciar nada.\n\n`PATCH /app/{id}`"]
pub async fn atualizar_pelo_id_app(
credencial_de_acesso: &CredencialDeAcesso,
id: &str,
corpo_da_requisicao: &tipos::AppAtualizar,
) -> Result<tipos::App, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/app/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista cargos com paginação\n\nSó master. Em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 500. `busca` procura no nome.\n\n`GET /cargo`"]
pub async fn buscar_paginador_cargo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorCargo,
) -> Result<tipos::PaginaCargo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/cargo")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra um cargo\n\nSó master. `nome` é obrigatório, de 1 a 120 caracteres, e não pode repetir outro cargo (sem diferenciar maiúsculas).\n\n`POST /cargo`"]
pub async fn criar_cargo(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::CargoCriar,
) -> Result<tipos::Cargo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/cargo")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de cargos para seleção\n\nSó master. Devolve só id e nome, em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 100. `busca` procura no nome.\n\n`GET /cargo/autocomplete`"]
pub async fn buscar_auto_complete_cargo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteCargo,
) -> Result<tipos::PaginaCargoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/cargo/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca cargos por filtro\n\nSó master. Devolve todos os cargos que casam com o filtro, sem paginação, em ordem alfabética. `busca` procura no nome.\n\n`GET /cargo/filtro`"]
pub async fn buscar_pelo_filtro_cargo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroCargo,
) -> Result<Vec<tipos::Cargo>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/cargo/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um cargo pelo id\n\nSó master. `quantidade_de_colaboradores` conta os usuários ligados ao cargo.\n\n`GET /cargo/{id}`"]
pub async fn buscar_pelo_id_cargo(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Cargo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/cargo/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Renomeia um cargo\n\nSó master. O nome novo já sai nas leituras de `/usuario` dos colaboradores do cargo.\n\n`PATCH /cargo/{id}`"]
pub async fn atualizar_pelo_id_cargo(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::CargoAtualizar,
) -> Result<tipos::Cargo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/cargo/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista funções com paginação\n\nSó master. Em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 500. `busca` procura no nome.\n\n`GET /funcao`"]
pub async fn buscar_paginador_funcao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorFuncao,
) -> Result<tipos::PaginaFuncao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/funcao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra uma função\n\nSó master. `nome` é obrigatório, de 1 a 120 caracteres, e não pode repetir outra função (sem diferenciar maiúsculas).\n\n`POST /funcao`"]
pub async fn criar_funcao(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::FuncaoCriar,
) -> Result<tipos::Funcao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/funcao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de funções para seleção\n\nSó master. Devolve só id e nome, em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 100. `busca` procura no nome.\n\n`GET /funcao/autocomplete`"]
pub async fn buscar_auto_complete_funcao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteFuncao,
) -> Result<tipos::PaginaFuncaoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/funcao/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca funções por filtro\n\nSó master. Devolve todas as funções que casam com o filtro, sem paginação, em ordem alfabética. `busca` procura no nome.\n\n`GET /funcao/filtro`"]
pub async fn buscar_pelo_filtro_funcao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroFuncao,
) -> Result<Vec<tipos::Funcao>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/funcao/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca uma função pelo id\n\nSó master. `quantidade_de_colaboradores` conta os usuários ligados à função.\n\n`GET /funcao/{id}`"]
pub async fn buscar_pelo_id_funcao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Funcao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/funcao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Renomeia uma função\n\nSó master. O nome novo já sai nas leituras de `/usuario` dos colaboradores da função.\n\n`PATCH /funcao/{id}`"]
pub async fn atualizar_pelo_id_funcao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::FuncaoAtualizar,
) -> Result<tipos::Funcao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/funcao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista setores com paginação\n\nSó master. Em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 500. `busca` procura no nome.\n\n`GET /setor`"]
pub async fn buscar_paginador_setor(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorSetor,
) -> Result<tipos::PaginaSetor, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/setor")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra um setor\n\nSó master. `nome` é obrigatório, de 1 a 120 caracteres, e não pode repetir outro setor (sem diferenciar maiúsculas).\n\n`POST /setor`"]
pub async fn criar_setor(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::SetorCriar,
) -> Result<tipos::Setor, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/setor")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de setores para seleção\n\nSó master. Devolve só id e nome, em ordem alfabética. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 100. `busca` procura no nome.\n\n`GET /setor/autocomplete`"]
pub async fn buscar_auto_complete_setor(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteSetor,
) -> Result<tipos::PaginaSetorAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/setor/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca setores por filtro\n\nSó master. Devolve todos os setores que casam com o filtro, sem paginação, em ordem alfabética. `busca` procura no nome.\n\n`GET /setor/filtro`"]
pub async fn buscar_pelo_filtro_setor(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroSetor,
) -> Result<Vec<tipos::Setor>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/setor/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um setor pelo id\n\nSó master. `quantidade_de_colaboradores` conta os usuários ligados ao setor.\n\n`GET /setor/{id}`"]
pub async fn buscar_pelo_id_setor(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Setor, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/setor/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Renomeia um setor\n\nSó master. O nome novo já sai nas leituras de `/usuario` dos colaboradores do setor.\n\n`PATCH /setor/{id}`"]
pub async fn atualizar_pelo_id_setor(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::SetorAtualizar,
) -> Result<tipos::Setor, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/setor/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista usuários com paginação\n\nSó master. Os mais recentes vêm primeiro. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10 e máximo 500. `busca` procura no nome e no e-mail; `perfil` é `colaborador` ou `cliente`; `setor_id`, `cargo_id` e `funcao_id` filtram pela estrutura; `acesso` é `senha` ou `google`; `dois_fatores` e `master` são `true` ou `false`.\n\n`GET /usuario`"]
pub async fn buscar_paginador_usuario(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorUsuario,
) -> Result<tipos::PaginaUsuario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/usuario")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de usuários para seleção\n\nSó master. Devolve só id, nome e e-mail, em ordem alfabética, para escolher um usuário. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10. `busca` procura no nome e no e-mail; `perfil` é `colaborador` ou `cliente`.\n\n`GET /usuario/autocomplete`"]
pub async fn buscar_auto_complete_usuario(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteUsuario,
) -> Result<tipos::PaginaUsuarioAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/usuario/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca usuários por filtro\n\nSó master. Devolve todos os usuários que casam com o filtro, sem paginação, em ordem alfabética. `busca` procura no nome e no e-mail; `perfil` é `colaborador` ou `cliente`.\n\n`GET /usuario/filtro`"]
pub async fn buscar_pelo_filtro_usuario(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroUsuario,
) -> Result<Vec<tipos::Usuario>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/usuario/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um usuário pelo id\n\nQuem não é master só consegue buscar o próprio usuário, cujo id é o `sub` do token.\n\n`GET /usuario/{id}`"]
pub async fn buscar_pelo_id_usuario(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Usuario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/usuario/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}