// 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_SUPPORT 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 `/anexo/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroAnexo {
#[serde(skip_serializing_if = "Option::is_none")]
pub tarefa_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ticket_id: Option<uuid::Uuid>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/aplicativo`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorAplicativo {
#[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 `/aplicativo/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteAplicativo {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub somente_ativos: Option<bool>,
#[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 `/aplicativo/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroAplicativo {
#[serde(skip_serializing_if = "Option::is_none")]
pub nome: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub endereco: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ativo: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/comentario`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorComentario {
#[serde(skip_serializing_if = "Option::is_none")]
pub tarefa_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ticket_id: Option<uuid::Uuid>,
#[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 `/comentario/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroComentario {
#[serde(skip_serializing_if = "Option::is_none")]
pub tarefa_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ticket_id: Option<uuid::Uuid>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/documento`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorDocumento {
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: 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 `/documento/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteDocumento {
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[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 `/documento/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroDocumento {
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub nome: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tipo: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub conteudo: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/etiqueta`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorEtiqueta {
#[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 `/etiqueta/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteEtiqueta {
#[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 `/etiqueta/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroEtiqueta {
#[serde(skip_serializing_if = "Option::is_none")]
pub nome: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/historico/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroHistorico {
#[serde(skip_serializing_if = "Option::is_none")]
pub tarefa_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ticket_id: Option<uuid::Uuid>,
}
#[doc = "Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`)."]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum BuscarPaginadorNotificacaoTipo {
#[serde(rename = "ATRIBUICAO")]
Atribuicao,
#[serde(rename = "COMENTARIO")]
Comentario,
#[serde(rename = "MENCAO")]
Mencao,
#[serde(rename = "STATUS")]
Status,
#[serde(rename = "PRAZO")]
Prazo,
#[serde(rename = "TICKET")]
Ticket,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/notificacao`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorNotificacao {
#[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 lida: Option<bool>,
#[doc = "Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`."]
#[serde(skip_serializing_if = "Option::is_none")]
pub tipo: Option<BuscarPaginadorNotificacaoTipo>,
}
#[doc = "Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`)."]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum BuscarPeloFiltroNotificacaoTipo {
#[serde(rename = "ATRIBUICAO")]
Atribuicao,
#[serde(rename = "COMENTARIO")]
Comentario,
#[serde(rename = "MENCAO")]
Mencao,
#[serde(rename = "STATUS")]
Status,
#[serde(rename = "PRAZO")]
Prazo,
#[serde(rename = "TICKET")]
Ticket,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/notificacao/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroNotificacao {
#[serde(skip_serializing_if = "Option::is_none")]
pub lida: Option<bool>,
#[doc = "Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`."]
#[serde(skip_serializing_if = "Option::is_none")]
pub tipo: Option<BuscarPeloFiltroNotificacaoTipo>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/projeto`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorProjeto {
#[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 status: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub membro_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub arquivado: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/projeto/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteProjeto {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: 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 `/projeto/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroProjeto {
#[doc = "Trecho do nome ou da descrição."]
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub status: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[doc = "Projetos em que o colaborador é dono ou membro."]
#[serde(skip_serializing_if = "Option::is_none")]
pub membro_id: Option<uuid::Uuid>,
#[doc = "Padrão `false`: os arquivados só aparecem quando pedidos."]
#[serde(skip_serializing_if = "Option::is_none")]
pub arquivado: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/publico/ticket`."]
#[derive(Debug, Clone, PartialEq, Serialize)]
pub struct ParametrosDeCriarPeloAplicativoTicket {
#[doc = "Chave pública do aplicativo (pk_live_...)"]
#[doc = "Enviado no cabeçalho `X-Chave-Publica`."]
#[serde(skip)]
pub x_chave_publica: String,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/secao`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorSecao {
#[serde(skip_serializing_if = "Option::is_none")]
pub projeto_id: Option<uuid::Uuid>,
#[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 `/secao/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteSecao {
#[serde(skip_serializing_if = "Option::is_none")]
pub projeto_id: Option<uuid::Uuid>,
#[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 `/secao/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroSecao {
#[serde(skip_serializing_if = "Option::is_none")]
pub projeto_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub nome: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/tarefa`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorTarefa {
#[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 projeto_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub responsavel_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub concluida: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/tarefa/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteTarefa {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub projeto_id: Option<uuid::Uuid>,
#[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 `/tarefa/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroTarefa {
#[serde(skip_serializing_if = "Option::is_none")]
pub projeto_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub secao_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub responsavel_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tarefa_pai_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub ticket_id: Option<uuid::Uuid>,
#[doc = "Tarefas dos projetos ligados a esse aplicativo."]
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub etiqueta_id: Option<uuid::Uuid>,
#[doc = "`true` deixa de fora as subtarefas."]
#[serde(skip_serializing_if = "Option::is_none")]
pub somente_principais: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub concluida: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub prazo_de: Option<chrono::NaiveDate>,
#[serde(skip_serializing_if = "Option::is_none")]
pub prazo_ate: Option<chrono::NaiveDate>,
#[doc = "Trecho do título ou da descrição."]
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[doc = "`true` ordena pelo prazo (mais próximo primeiro); senão pela coluna e pela ordem do quadro."]
#[serde(skip_serializing_if = "Option::is_none")]
pub ordenar_por_prazo: Option<bool>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/tarefa/{id}`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeDeletarPeloIdTarefa {
#[doc = "`esta` (padrão) exclui só esta tarefa; `proximas` exclui esta e as próximas da série e para a\ncriação diária. Em tarefa que não é recorrente, os dois excluem só ela."]
#[serde(skip_serializing_if = "Option::is_none")]
pub recorrencia: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/ticket`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPaginadorTicket {
#[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 aplicativo_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub status: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub abertos: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub responsavel_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub sem_responsavel: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub solicitante_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub prioridade: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tipo: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub atrasados: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Parâmetros de consulta e de cabeçalho de `/ticket/autocomplete`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarAutoCompleteTicket {
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: 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 `/ticket/filtro`."]
#[derive(Debug, Clone, Default, PartialEq, Serialize)]
pub struct ParametrosDeBuscarPeloFiltroTicket {
#[serde(skip_serializing_if = "Option::is_none")]
pub aplicativo_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub status: Option<String>,
#[doc = "`true` traz só os que não estão resolvidos nem fechados; `false`, só os resolvidos e fechados."]
#[serde(skip_serializing_if = "Option::is_none")]
pub abertos: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub responsavel_id: Option<uuid::Uuid>,
#[doc = "`true` traz só os tickets sem responsável."]
#[serde(skip_serializing_if = "Option::is_none")]
pub sem_responsavel: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub solicitante_id: Option<uuid::Uuid>,
#[serde(skip_serializing_if = "Option::is_none")]
pub prioridade: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub tipo: Option<String>,
#[doc = "`true` traz só os que estouraram o prazo."]
#[serde(skip_serializing_if = "Option::is_none")]
pub atrasados: Option<bool>,
#[doc = "Trecho do título, da descrição, do solicitante ou o número."]
#[serde(skip_serializing_if = "Option::is_none")]
pub busca: Option<String>,
}
#[doc = "Anexa um arquivo ou link\n\nExige a permissão `criar` na área `projetos` ou `tickets`. Anexa a uma tarefa (`tarefa_id`) ou ticket (`ticket_id`), nunca aos dois. Mande o arquivo em `arquivo_base64` (com ou sem o prefixo `data:...;base64,`, até 10 MB, `tipo_mime` informa o formato) ou um link em `url` (`http://` ou `https://`, até 1000 caracteres). Com `importar_url: true`, o servidor baixa a imagem de `url` e guarda o arquivo no lugar do link (é o caminho para anexar imagens pelo MCP): só `https://`, sem redirecionamento, servidor de IP público, resposta `image/*` de até 10 MB; o `tipo_mime` vem da resposta. `nome` é obrigatório (até 200). O arquivo vai para o TermoBucket (privado, app `termo-suporte`); se o bucket falhar, responde `502` e nada é gravado (o arquivo nunca fica no banco). O corpo aceita até 16 MiB. A atividade da tarefa ou do ticket ganha a linha do anexo.\n\n`POST /anexo`"]
pub async fn criar_anexo(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::AnexoCriar,
) -> Result<tipos::Anexo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/anexo")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista os anexos de uma tarefa ou ticket\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 anexos, do mais novo para o mais antigo, sem o conteúdo dos arquivos. Informe `tarefa_id` ou `ticket_id`.\n\n`GET /anexo/filtro`"]
pub async fn buscar_pelo_filtro_anexo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroAnexo,
) -> Result<Vec<tipos::Anexo>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/anexo/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Baixa um anexo pelo id\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve os dados do anexo e, quando é arquivo, `url_download`: endereço de download assinado do TermoBucket (arquivo privado do app `termo-suporte`), válido por 15 minutos. `url_download` fica vazia quando o anexo é um link.\n\n`GET /anexo/{id}`"]
pub async fn buscar_pelo_id_anexo(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::AnexoComConteudo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/anexo/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Renomeia um anexo pelo id\n\nExige a permissão `editar` na área `projetos` ou `tickets`. Troca o `nome` (obrigatório, até 200 caracteres).\n\n`PATCH /anexo/{id}`"]
pub async fn atualizar_pelo_id_anexo(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::AnexoAtualizar,
) -> Result<tipos::Anexo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/anexo/{}", 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 = "Exclui um anexo pelo id\n\nExige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica.\n\n`DELETE /anexo/{id}`"]
pub async fn deletar_pelo_id_anexo(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/anexo/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Lista os aplicativos paginados\n\nExige a permissão de leitura na área `aplicativos`. A lista de aplicativos é a do TermoAuth (não há cadastro, edição nem exclusão no TermoSupport): antes de responder, a rota busca os apps no TermoAuth pelo `termo_core` com o token de quem chamou e espelha nome, endereço, descrição e cor. Para um master do TermoAuth vem a lista inteira (`todos=true`) e o que sumiu de lá fica inativo; para os demais, só entram ou se atualizam os apps que a pessoa pode abrir. Falha no TermoAuth não impede a resposta: vem o que já estava sincronizado. A sincronização também roda quando um master entra. Lista os aplicativos sincronizados (com `termoauth_id`) em ordem alfabética do nome, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1 (padrão 1; valores menores viram 1). `total` é a quantidade de aplicativos não excluídos.\n\n`GET /aplicativo`"]
pub async fn buscar_paginador_aplicativo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorAplicativo,
) -> Result<tipos::PaginaAplicativo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/aplicativo")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de aplicativos para seleção\n\nExige a permissão de leitura na área `aplicativos`, `projetos` ou `tickets`. Devolve só id, nome e endereço, em ordem alfabética do nome, sem os excluídos. `somente_ativos=true` deixa de fora os aplicativos inativos (é o que usam os campos de projetos e tickets). `busca` procura o trecho no nome ou no endereço, 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.\n\n`GET /aplicativo/autocomplete`"]
pub async fn buscar_auto_complete_aplicativo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteAplicativo,
) -> Result<tipos::PaginaAplicativoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
"/aplicativo/autocomplete",
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca aplicativos por filtro\n\nExige a permissão de leitura na área `aplicativos`. Devolve todos os aplicativos sincronizados com o TermoAuth que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` e `endereco` procuram o trecho no campo, sem diferenciar maiúsculas; `ativo` filtra pela situação. Sem filtro, devolve todos.\n\n`GET /aplicativo/filtro`"]
pub async fn buscar_pelo_filtro_aplicativo(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroAplicativo,
) -> Result<Vec<tipos::Aplicativo>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/aplicativo/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um aplicativo pelo id\n\nExige a permissão de leitura na área `aplicativos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Aplicativo excluído não é encontrado.\n\n`GET /aplicativo/{id}`"]
pub async fn buscar_pelo_id_aplicativo(
credencial_de_acesso: &CredencialDeAcesso,
id: &str,
) -> Result<tipos::Aplicativo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/aplicativo/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista os comentários paginados\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Do mais novo para o mais antigo, sempre 50 por página: `tamanho` é ignorado. `tarefa_id` e `ticket_id` limitam a uma tarefa ou ticket.\n\n`GET /comentario`"]
pub async fn buscar_paginador_comentario(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorComentario,
) -> Result<tipos::PaginaComentario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/comentario")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Comenta numa tarefa ou ticket\n\nExige a permissão `criar` na área `projetos` ou `tickets`. Grava o comentário de quem está logado em uma tarefa (`tarefa_id`) ou um ticket (`ticket_id`), nunca nos dois. `texto` é obrigatório (até 10000 caracteres). `interno` (só no ticket) vira nota que o solicitante não acompanha. `mencionados` são os colaboradores marcados com @, que recebem notificação; o responsável e o criador da tarefa (ou o responsável e o solicitante do ticket) também são avisados. A primeira resposta pública da equipe num ticket novo registra a primeira resposta e o põe em atendimento.\n\n`POST /comentario`"]
pub async fn criar_comentario(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::ComentarioCriar,
) -> Result<tipos::Comentario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/comentario")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista a conversa de uma tarefa ou ticket\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 1000 comentários do mais antigo para o mais novo. Informe `tarefa_id` ou `ticket_id`.\n\n`GET /comentario/filtro`"]
pub async fn buscar_pelo_filtro_comentario(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroComentario,
) -> Result<Vec<tipos::Comentario>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/comentario/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um comentário pelo id\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Comentário excluído não é encontrado.\n\n`GET /comentario/{id}`"]
pub async fn buscar_pelo_id_comentario(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Comentario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/comentario/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Edita um comentário pelo id\n\nExige a permissão `editar` na área `projetos` ou `tickets`. Troca o `texto` (obrigatório, até 10000 caracteres). Só quem escreveu edita; o comentário passa a mostrar `editado`.\n\n`PATCH /comentario/{id}`"]
pub async fn atualizar_pelo_id_comentario(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::ComentarioAtualizar,
) -> Result<tipos::Comentario, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/comentario/{}", 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 = "Exclui um comentário pelo id\n\nExige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica. Só quem escreveu exclui.\n\n`DELETE /comentario/{id}`"]
pub async fn deletar_pelo_id_comentario(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/comentario/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Lista os documentos paginados\n\nExige a permissão de leitura na área `aplicativos`. Lista os documentos não excluídos em ordem alfabética do nome, sempre 50 por página: `tamanho` é ignorado. `aplicativo_id` limita a um aplicativo. `pagina` começa em 1 (padrão 1; valores menores viram 1). `total` conta os documentos com o mesmo filtro de aplicativo.\n\n`GET /documento`"]
pub async fn buscar_paginador_documento(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorDocumento,
) -> Result<tipos::PaginaDocumento, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/documento")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra um documento de um aplicativo\n\nExige a permissão `criar` na área `aplicativos`. Cadastra um documento da base de conhecimento de um aplicativo. `aplicativo_id` precisa ser de um aplicativo não excluído. `nome` é obrigatório (até 120 caracteres). `tipo` é `TEXTO`, `TXT`, `MD` ou `PDF`, sem diferenciar maiúsculas (padrão `TEXTO`, gravado em maiúsculas). O conteúdo vem em `conteudo` (texto) ou em `arquivo_base64` (o arquivo em base64, com ou sem o prefixo `data:...;base64,`); quando `arquivo_base64` vem preenchido, `conteudo` é ignorado. Com `tipo` `PDF` o backend extrai o texto do PDF; nos demais tipos o arquivo precisa ser texto UTF-8. O texto final não pode ficar vazio, e `caracteres` é o tamanho dele. O corpo aceita até 8 MiB (um PDF de cerca de 5 MB em base64).\n\n`POST /documento`"]
pub async fn criar_documento(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::DocumentoCriar,
) -> Result<tipos::Documento, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/documento")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de documentos para seleção\n\nExige a permissão de leitura na área `aplicativos`. Devolve só id, nome e tipo, em ordem alfabética do nome, sem os excluídos. `aplicativo_id` limita a um aplicativo e `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.\n\n`GET /documento/autocomplete`"]
pub async fn buscar_auto_complete_documento(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteDocumento,
) -> Result<tipos::PaginaDocumentoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/documento/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca documentos por filtro\n\nExige a permissão de leitura na área `aplicativos`. Devolve todos os documentos não excluídos que casam com o filtro, sem paginação, em ordem alfabética do nome, com o texto inteiro. `aplicativo_id` limita a um aplicativo; `nome` e `conteudo` procuram o trecho no campo, sem diferenciar maiúsculas; `tipo` é exato (`TEXTO`, `TXT`, `MD` ou `PDF`, sem diferenciar maiúsculas). Sem filtro, devolve todos.\n\n`GET /documento/filtro`"]
pub async fn buscar_pelo_filtro_documento(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroDocumento,
) -> Result<Vec<tipos::Documento>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/documento/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um documento pelo id\n\nExige a permissão de leitura na área `aplicativos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o documento com o texto inteiro em `conteudo`. Documento excluído não é encontrado.\n\n`GET /documento/{id}`"]
pub async fn buscar_pelo_id_documento(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Documento, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/documento/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza um documento pelo id\n\nExige a permissão `editar` na área `aplicativos`. Atualização parcial: só os campos enviados mudam; o aplicativo do documento não muda. `nome` não pode ficar vazio (até 120 caracteres) e `tipo` é `TEXTO`, `TXT`, `MD` ou `PDF`. Mandar `conteudo` ou `arquivo_base64` troca o texto, com as mesmas regras do cadastro (o arquivo é lido pelo `tipo` enviado ou, sem ele, pelo tipo atual do documento) e o texto final não pode ficar vazio. O corpo aceita até 8 MiB.\n\n`PATCH /documento/{id}`"]
pub async fn atualizar_pelo_id_documento(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::DocumentoAtualizar,
) -> Result<tipos::Documento, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/documento/{}", 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 = "Exclui um documento pelo id\n\nExige a permissão `deletar` na área `aplicativos`. A exclusão é lógica: o documento some das leituras, mas o registro não é apagado e não há como restaurá-lo.\n\n`DELETE /documento/{id}`"]
pub async fn deletar_pelo_id_documento(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/documento/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Lista as etiquetas paginadas\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista em ordem alfabética, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1.\n\n`GET /etiqueta`"]
pub async fn buscar_paginador_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorEtiqueta,
) -> Result<tipos::PaginaEtiqueta, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/etiqueta")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra uma etiqueta\n\nExige a permissão `criar` na área `projetos`. Cria uma etiqueta para marcar tarefas (Backend, Frontend, Dados...). `nome` é obrigatório (até 40 caracteres) e único sem diferenciar maiúsculas. `cor` segue o formato `#00397c` (padrão `#00397c`).\n\n`POST /etiqueta`"]
pub async fn criar_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::EtiquetaCriar,
) -> Result<tipos::Etiqueta, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/etiqueta")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de etiquetas para seleção\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, nome e cor, em ordem alfabética. `busca` procura o trecho no nome. `pagina` começa em 1 e `tamanho` tem padrão 10.\n\n`GET /etiqueta/autocomplete`"]
pub async fn buscar_auto_complete_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteEtiqueta,
) -> Result<tipos::PaginaEtiquetaResumo, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/etiqueta/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca etiquetas por filtro\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve todas as etiquetas não excluídas, em ordem alfabética. `nome` procura o trecho no nome, sem diferenciar maiúsculas.\n\n`GET /etiqueta/filtro`"]
pub async fn buscar_pelo_filtro_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroEtiqueta,
) -> Result<Vec<tipos::Etiqueta>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/etiqueta/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca uma etiqueta pelo id\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Etiqueta excluída não é encontrada.\n\n`GET /etiqueta/{id}`"]
pub async fn buscar_pelo_id_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Etiqueta, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/etiqueta/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza uma etiqueta pelo id\n\nExige a permissão `editar` na área `projetos`. Atualização parcial de `nome` e `cor`, com as mesmas regras do cadastro.\n\n`PATCH /etiqueta/{id}`"]
pub async fn atualizar_pelo_id_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::EtiquetaAtualizar,
) -> Result<tipos::Etiqueta, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/etiqueta/{}", 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 = "Exclui uma etiqueta pelo id\n\nExige a permissão `deletar` na área `projetos`. Exclusão lógica: a etiqueta some das leituras e sai das tarefas que a usavam.\n\n`DELETE /etiqueta/{id}`"]
pub async fn deletar_pelo_id_etiqueta(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/etiqueta/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Atividade de uma tarefa ou ticket\n\nExige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 linhas de atividade, da mais nova para a mais antiga: criação, mudanças de campo, anexos. O histórico é gravado pelo próprio sistema e não tem cadastro, edição nem exclusão. Informe `tarefa_id` ou `ticket_id`.\n\n`GET /historico/filtro`"]
pub async fn buscar_pelo_filtro_historico(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroHistorico,
) -> Result<Vec<tipos::Historico>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/historico/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Caixa de entrada paginada\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` e `tipo` (`ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`; vazio é sem filtro) filtram; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.\n\n`GET /notificacao`"]
pub async fn buscar_paginador_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorNotificacao,
) -> Result<tipos::PaginaNotificacao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/notificacao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Marca todas as notificações como lidas\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Marca de uma vez todas as notificações da pessoa como lidas (ou como não lidas, com `lida: false`). Devolve quantas mudaram em `alteradas`.\n\n`PATCH /notificacao`"]
pub async fn marcar_todas_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::NotificacaoMarcarTodas,
) -> Result<tipos::NotificacoesMarcadas, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::PATCH, "/notificacao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca notificações por filtro\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Devolve até 500 notificações da pessoa, da mais nova para a mais antiga. `lida` filtra lidas ou não lidas e `tipo` é `ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`.\n\n`GET /notificacao/filtro`"]
pub async fn buscar_pelo_filtro_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroNotificacao,
) -> Result<Vec<tipos::Notificacao>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/notificacao/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca uma notificação pelo id\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Só encontra as notificações da própria pessoa.\n\n`GET /notificacao/{id}`"]
pub async fn buscar_pelo_id_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Notificacao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/notificacao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Marca uma notificação como lida ou não lida\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Muda `lida` de uma notificação da própria pessoa.\n\n`PATCH /notificacao/{id}`"]
pub async fn atualizar_pelo_id_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::NotificacaoAtualizar,
) -> Result<tipos::Notificacao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/notificacao/{}", 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 = "Exclui uma notificação pelo id\n\nLivre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Tira a notificação da caixa de entrada (exclusão lógica).\n\n`DELETE /notificacao/{id}`"]
pub async fn deletar_pelo_id_notificacao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/notificacao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Lista os projetos paginados\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista os projetos do mais recente atualizado para o mais antigo, sempre 50 por página: `tamanho` é ignorado. Aceita os mesmos filtros do `GET /projeto/filtro`. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /projeto`"]
pub async fn buscar_paginador_projeto(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorProjeto,
) -> Result<tipos::PaginaProjeto, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/projeto")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra um projeto\n\nExige a permissão `criar` na área `projetos`. `visibilidade` é `ORGANIZACAO` (padrão: todos com a área `projetos` veem) ou `MEMBROS` (só quem está vinculado ao projeto). Cria o projeto ligado aos aplicativos de `aplicativo_ids`, com os membros de `membro_ids` (o dono e quem criou entram sempre como membros). `nome` é obrigatório (até 120 caracteres); `descricao` vai até 5000; `cor` no formato `#00397c`; `status` é `NO_PRAZO` (padrão), `EM_RISCO`, `ATRASADO`, `PAUSADO` ou `CONCLUIDO`; `dono_id` tem padrão em quem criou; `inicio` não pode passar do `prazo`. `secoes` são os nomes das colunas do quadro, na ordem (padrão \"A fazer\", \"Em andamento\" e \"Concluído\").\n\n`POST /projeto`"]
pub async fn criar_projeto(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::ProjetoCriar,
) -> Result<tipos::Projeto, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/projeto")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de projetos para seleção\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, nome e cor dos projetos não arquivados, em ordem alfabética. `busca` procura no nome e `aplicativo_id` limita aos projetos do aplicativo. `pagina` começa em 1 e `tamanho` tem padrão 10. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /projeto/autocomplete`"]
pub async fn buscar_auto_complete_projeto(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteProjeto,
) -> Result<tipos::PaginaProjetoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/projeto/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca projetos por filtro\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 projetos em ordem alfabética. `busca` procura no nome e na descrição; `status` é exato; `aplicativo_id` traz os projetos ligados ao aplicativo; `membro_id` os projetos em que o colaborador é dono ou membro; `arquivado` tem padrão `false`. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /projeto/filtro`"]
pub async fn buscar_pelo_filtro_projeto(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroProjeto,
) -> Result<Vec<tipos::Projeto>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/projeto/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um projeto pelo id\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o projeto com dono, aplicativos, membros e a contagem das tarefas principais (total, concluídas e atrasadas). Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /projeto/{id}`"]
pub async fn buscar_pelo_id_projeto(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Projeto, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/projeto/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza um projeto pelo id\n\nExige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro (inclusive `visibilidade`: `ORGANIZACAO` ou `MEMBROS`). Texto vazio em `descricao` apaga; `null` em `dono_id`, `inicio` ou `prazo` apaga o valor. `aplicativo_ids` e `membro_ids`, quando enviados, substituem a lista inteira (o dono continua membro). `arquivado` tira o projeto das listas. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`PATCH /projeto/{id}`"]
pub async fn atualizar_pelo_id_projeto(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::ProjetoAtualizar,
) -> Result<tipos::Projeto, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/projeto/{}", 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 = "Exclui um projeto pelo id\n\nExige a permissão `deletar` na área `projetos`. Exclusão lógica do projeto, das colunas e das tarefas dele. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`DELETE /projeto/{id}`"]
pub async fn deletar_pelo_id_projeto(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/projeto/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Abre um ticket pelo aplicativo atendido\n\nRota pública, sem o token do TermoAuth: o backend do aplicativo se identifica pela chave pública dele (`pk_live_...`, a mesma do cadastro do aplicativo) no cabeçalho `X-Chave-Publica`. Só aplicativo ativo abre ticket. `titulo` (até 200), `descricao` (até 20000) e `solicitante_nome` (até 120) são obrigatórios; `solicitante_email`, `origem_url` (a tela onde o problema aconteceu), `tipo` e `prioridade` seguem as regras do `POST /ticket`. O ticket entra na fila com o canal `APLICATIVO`, o status `NOVO` e o prazo do SLA. Chamada de servidor para servidor: o navegador recebe erro de CORS.\n\n`POST /publico/ticket`"]
pub async fn criar_pelo_aplicativo_ticket(
parametros: &ParametrosDeCriarPeloAplicativoTicket,
corpo_da_requisicao: &tipos::TicketDoAplicativo,
) -> Result<tipos::TicketAberto, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/publico/ticket")
.com_cabecalho_opcional("X-Chave-Publica", Some(¶metros.x_chave_publica))
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista as seções paginadas\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista na ordem do quadro, sempre 50 por página: `tamanho` é ignorado. `projeto_id` limita a um projeto.\n\n`GET /secao`"]
pub async fn buscar_paginador_secao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorSecao,
) -> Result<tipos::PaginaSecao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/secao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra uma seção (coluna do quadro)\n\nExige a permissão `criar` na área `projetos`. Cria a coluna no projeto. `nome` é obrigatório (até 80 caracteres). Sem `ordem`, entra no fim do quadro.\n\n`POST /secao`"]
pub async fn criar_secao(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::SecaoCriar,
) -> Result<tipos::Secao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/secao")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de seções para seleção\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id e nome em ordem alfabética. `projeto_id` limita a um projeto e `busca` procura no nome.\n\n`GET /secao/autocomplete`"]
pub async fn buscar_auto_complete_secao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteSecao,
) -> Result<tipos::PaginaSecaoAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/secao/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca seções por filtro\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve as colunas na ordem do quadro. `projeto_id` limita a um projeto e `nome` procura o trecho no nome.\n\n`GET /secao/filtro`"]
pub async fn buscar_pelo_filtro_secao(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroSecao,
) -> Result<Vec<tipos::Secao>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/secao/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca uma seção pelo id\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Seção excluída não é encontrada.\n\n`GET /secao/{id}`"]
pub async fn buscar_pelo_id_secao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Secao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/secao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza uma seção pelo id\n\nExige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas). `conclui_tarefa: true` faz dela a coluna que conclui do projeto (uma só): desliga a anterior, conclui as tarefas principais abertas dela e traz para o fim dela as concluídas das outras colunas, com a linha na atividade de cada tarefa; `false` só desliga, sem mexer em tarefa. `gatilho_url` (https://) e `gatilho_token` cadastram o gatilho da coluna: quando um cartão entra nela (arrasto, gaveta, em massa ou pela API) o sistema faz `POST` no endereço com `Authorization: Bearer <token>` e o corpo `{ \"text\": \"...\" }` com os dados da tarefa (o formato do gatilho por API das tarefas agendadas do Claude), e o botão de play do cartão (`POST /tarefa/{id}/gatilho`) dispara de novo. `null` ou texto vazio tira; sem endereço o token sai junto. O token é guardado cifrado e nunca volta: a resposta só diz `gatilho_token_configurado` e os 4 últimos caracteres.\n\n`PATCH /secao/{id}`"]
pub async fn atualizar_pelo_id_secao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::SecaoAtualizar,
) -> Result<tipos::Secao, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/secao/{}", 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 = "Exclui uma seção pelo id\n\nExige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto (a que conclui só se não sobrar outra, e aí as abertas são concluídas). A coluna que conclui não sai: desligue a opção antes.\n\n`DELETE /secao/{id}`"]
pub async fn deletar_pelo_id_secao(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/secao/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Lista as tarefas paginadas\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista da mais recente para a mais antiga, sempre 50 por página: `tamanho` é ignorado. Filtra por `projeto_id`, `responsavel_id`, `concluida` e `busca` (título). Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /tarefa`"]
pub async fn buscar_paginador_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorTarefa,
) -> Result<tipos::PaginaTarefa, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/tarefa")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Cadastra uma tarefa\n\nExige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna que não conclui tarefas (na que conclui, já nasce concluída); com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` e `prazo` são obrigatórios (título até 300 caracteres); sem `inicio`, ele é hoje (São Paulo) e não pode passar do `prazo`; sem `responsavel_id`, quem criou vira o responsável. `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos. Com `recorrente: true` a tarefa é agendada: `prazo` é o dia agendado (não pode ser antes de hoje), o início fica no mesmo dia e, dali para frente, o sistema cria uma cópia por dia (início e prazo no próprio dia, na mesma coluna, copiando título, descrição, responsável, prioridade, estimativa, marco e etiquetas da última tarefa da série); todas trazem o mesmo `recorrencia_id` e o dia em `recorrencia_data`. Subtarefa não pode ser recorrente. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`POST /tarefa`"]
pub async fn criar_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::TarefaCriar,
) -> Result<tipos::Tarefa, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/tarefa")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de tarefas para seleção\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, título e nome do projeto, em ordem alfabética. `busca` procura no título e `projeto_id` limita a um projeto. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /tarefa/autocomplete`"]
pub async fn buscar_auto_complete_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteTarefa,
) -> Result<tipos::PaginaTarefaAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/tarefa/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Aplica a mesma mudança em várias tarefas\n\nExige a permissão `editar` na área `projetos`. Aplica a mesma mudança em 1 a 500 tarefas (`tarefa_ids`, sem repetição), com pelo menos um destes campos: `secao_id` leva as tarefas principais para o fim dessa coluna, na ordem pedida (as tarefas e a coluna precisam ser do mesmo projeto); `responsavel_id` troca o responsável (`null` tira); `prazo` troca o prazo (`null` apaga; não pode ficar antes do início de nenhuma); `etiqueta_adicionar` põe a etiqueta em quem não a tem e `etiqueta_remover` tira de quem tem. Tudo é conferido antes de gravar: uma tarefa inexistente, subtarefa (com `secao_id`), de outro projeto ou com prazo antes do início recusa o pedido inteiro. A tarefa em que nada muda fica como está. Vale a regra da coluna que conclui do `PATCH /tarefa/{id}`: entrar nela conclui e sair reabre. Cada tarefa alterada ganha as linhas na atividade; o novo responsável e, ao concluir, o criador recebem notificação. Devolve as tarefas pedidas, já atualizadas, na ordem pedida. As tarefas são gravadas uma a uma: se o pedido parar no meio, repeti-lo completa só o que faltou. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais a coluna e as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.\n\n`PATCH /tarefa/em_massa`"]
pub async fn atualizar_em_massa_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::TarefaAtualizarEmMassa,
) -> Result<Vec<tipos::Tarefa>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::PATCH, "/tarefa/em_massa")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Exclui várias tarefas\n\nExige a permissão `deletar` na área `projetos`. Exclusão lógica de 1 a 500 tarefas (`tarefa_ids`, sem repetição) e das subtarefas delas. Tudo é conferido antes de gravar: uma tarefa inexistente ou já excluída recusa o pedido inteiro. As tarefas são excluídas uma a uma: se o pedido parar no meio, repeti-lo com as que sobraram termina a exclusão. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.\n\n`DELETE /tarefa/em_massa`"]
pub async fn deletar_em_massa_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::TarefaDeletarEmMassa,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::DELETE, "/tarefa/em_massa")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Busca tarefas por filtro\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 2000 tarefas. É a leitura do quadro, da lista, do calendário, do cronograma e de \"Minhas tarefas\". Os filtros se somam: `projeto_id`, `secao_id`, `responsavel_id`, `tarefa_pai_id` (subtarefas de uma tarefa), `ticket_id`, `aplicativo_id` (projetos ligados ao aplicativo), `etiqueta_id`, `somente_principais` (sem subtarefas), `concluida`, `prazo_de`/`prazo_ate` e `busca` (título ou descrição). A ordem é a do quadro (coluna e posição) ou, com `ordenar_por_prazo=true`, o prazo mais próximo primeiro.\n\n`GET /tarefa/filtro`"]
pub async fn buscar_pelo_filtro_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroTarefa,
) -> Result<Vec<tipos::Tarefa>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/tarefa/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca uma tarefa pelo id\n\nExige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve a tarefa com projeto, coluna, responsável, criador, etiquetas e as contagens de subtarefas, comentários e anexos. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`GET /tarefa/{id}`"]
pub async fn buscar_pelo_id_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Tarefa, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/tarefa/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza uma tarefa pelo id\n\nExige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. Na tarefa principal, a coluna que conclui manda: entrar nela conclui e sair reabre (vence um `concluida` contraditório); marcar `concluida` fora dela leva a tarefa para o fim dela; desmarcar dentro dela devolve a tarefa para o fim da coluna anterior. `etiqueta_ids` substitui a lista. Dependências (fluxo entre tarefas, inclusive de projetos diferentes): `depende_de_ids` substitui a lista das tarefas que precisam ser concluídas antes desta (até 50, todas visíveis para quem chama, nunca a própria nem uma que já espera por esta, senão `400`; subtarefa não tem dependências) e `ao_liberar_secao_id` escolhe a coluna deste projeto para onde ela vai quando a última dependência for concluída (`null` = a coluna \"A fazer\", achada pelo nome). A liberação acontece uma vez por lista de dependências, move para o fim da coluna, dispara o gatilho dela, entra na atividade, avisa o responsável e segue em cascata se a coluna de destino concluir a tarefa. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`PATCH /tarefa/{id}`"]
pub async fn atualizar_pelo_id_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::TarefaAtualizar,
) -> Result<tipos::Tarefa, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/tarefa/{}", 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 = "Exclui uma tarefa pelo id\n\nExige a permissão `deletar` na área `projetos`. Exclusão lógica da tarefa e das subtarefas dela. Em tarefa agendada (com `recorrencia_id`), `recorrencia=proximas` exclui esta e as próximas tarefas da série (dia igual ou depois do dela) e para a criação diária; `recorrencia=esta` (padrão) exclui só esta e a série continua. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.\n\n`DELETE /tarefa/{id}`"]
pub async fn deletar_pelo_id_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
parametros: &ParametrosDeDeletarPeloIdTarefa,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/tarefa/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ignorar_corpo_da_resposta()
.await
}
#[doc = "Busca as dependências de uma tarefa\n\nExige a permissão de leitura na área `projetos`. Devolve as tarefas (de qualquer projeto) que precisam ser concluídas antes desta em `depende_de`, as que esperam por esta em `libera` (cada uma com projeto, coluna e se já foi concluída) e a coluna para onde esta vai quando for liberada (`ao_liberar_secao_id`/`ao_liberar_secao_nome`: a escolhida ou a \"A fazer\"). Tarefas de projetos que a pessoa não enxerga não aparecem, só a contagem em `ocultas`. Visibilidade: tarefa de projeto que a pessoa não enxerga responde `404`.\n\n`GET /tarefa/{id}/dependencias`"]
pub async fn buscar_dependencias_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::TarefaDependencias, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!(
"/tarefa/{}/dependencias",
codificar_parametro_de_caminho(id)
),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Roda de novo o gatilho da coluna da tarefa\n\nExige a permissão `criar` na área `projetos`. É o botão de play do cartão: faz `POST` no endereço do gatilho da coluna em que a tarefa está (o mesmo disparo de quando o cartão entra na coluna), com `Authorization: Bearer <token>` e `{ \"text\": \"...\" }` com título, projeto, coluna, link, responsável, prioridade, prazo, etiquetas e descrição. Para o gatilho por API das tarefas agendadas do Claude (`api.anthropic.com`) vão também os cabeçalhos `anthropic-beta` e `anthropic-version`. O resultado fica em `gatilho` da tarefa (`OK`/`FALHA`, com a sessão aberta em `sessao_url`) e na atividade. Visibilidade: tarefa de projeto que a pessoa não enxerga responde `404`.\n\n`POST /tarefa/{id}/gatilho`"]
pub async fn disparar_gatilho_tarefa(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Tarefa, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::POST,
&format!("/tarefa/{}/gatilho", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Fila de tickets paginada\n\nExige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). A fila de atendimento: abertos primeiro, do mais urgente e com prazo mais próximo para o menos urgente; depois os resolvidos e fechados. Sempre 50 por página: `tamanho` é ignorado. Aceita os mesmos filtros do `GET /ticket/filtro`.\n\n`GET /ticket`"]
pub async fn buscar_paginador_ticket(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPaginadorTicket,
) -> Result<tipos::PaginaTicket, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/ticket")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Abre um ticket de suporte\n\nExige a permissão `criar` na área `tickets`. Abre o ticket para um aplicativo. `titulo` (até 200) e `descricao` (até 20000) são obrigatórios. `tipo` é `BUG`, `DUVIDA` (padrão), `MELHORIA`, `ACESSO` ou `OUTRO`; `prioridade` é `BAIXA`, `MEDIA` (padrão), `ALTA` ou `URGENTE`; `canal` é `PAINEL` (padrão), `APLICATIVO`, `EMAIL`, `WHATSAPP` ou `TELEFONE`. O solicitante é o colaborador de `solicitante_id`, ou alguém de fora por `solicitante_nome` e `solicitante_email`; sem nenhum, é quem abriu. Sem `prazo`, vale o SLA da prioridade (urgente 4 h, alta 24 h, média 72 h, baixa 7 dias). Com `responsavel_id` o ticket já nasce em atendimento e o responsável é notificado.\n\n`POST /ticket`"]
pub async fn criar_ticket(
credencial_de_acesso: &CredencialDeAcesso,
corpo_da_requisicao: &tipos::TicketCriar,
) -> Result<tipos::Ticket, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::POST, "/ticket")
.com_credencial_de_acesso(credencial_de_acesso)
.com_corpo_json(corpo_da_requisicao)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Lista básica de tickets para seleção\n\nExige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, número e título, do número maior para o menor. `busca` procura no título ou pelo número; `aplicativo_id` limita a um aplicativo.\n\n`GET /ticket/autocomplete`"]
pub async fn buscar_auto_complete_ticket(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarAutoCompleteTicket,
) -> Result<tipos::PaginaTicketAutoComplete, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/ticket/autocomplete")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca tickets por filtro\n\nExige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 2000 tickets do mais novo para o mais antigo. Os filtros se somam: `aplicativo_id`, `status`, `abertos` (sem os resolvidos e fechados; `false` só eles), `responsavel_id`, `sem_responsavel`, `solicitante_id`, `prioridade`, `tipo`, `atrasados` e `busca` (título, descrição, solicitante ou número, com ou sem #).\n\n`GET /ticket/filtro`"]
pub async fn buscar_pelo_filtro_ticket(
credencial_de_acesso: &CredencialDeAcesso,
parametros: &ParametrosDeBuscarPeloFiltroTicket,
) -> Result<Vec<tipos::Ticket>, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(&SERVICO_DESTA_API, Method::GET, "/ticket/filtro")
.com_credencial_de_acesso(credencial_de_acesso)
.com_parametros_de_consulta(parametros)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Busca um ticket pelo id\n\nExige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o ticket com aplicativo, solicitante, responsável, prazo (e se está atrasado), as tarefas de projeto criadas a partir dele e as contagens de comentários e anexos.\n\n`GET /ticket/{id}`"]
pub async fn buscar_pelo_id_ticket(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<tipos::Ticket, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::GET,
&format!("/ticket/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ler_resposta_json()
.await
}
#[doc = "Atualiza um ticket pelo id\n\nExige a permissão `editar` na área `tickets`. Atualização parcial com as regras da abertura, mais `status` (`NOVO`, `EM_ATENDIMENTO`, `AGUARDANDO`, `RESOLVIDO`, `FECHADO`). Resolver ou fechar grava a data; reabrir apaga. Sair de `NOVO` conta como primeira resposta. Trocar a `prioridade` sem mandar `prazo` refaz o prazo pelo SLA a partir da abertura. `null` em `responsavel_id`, `prazo` ou `solicitante_email` apaga o valor. Cada mudança entra na atividade; o novo responsável e o solicitante (na troca de status) são notificados.\n\n`PATCH /ticket/{id}`"]
pub async fn atualizar_pelo_id_ticket(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
corpo_da_requisicao: &tipos::TicketAtualizar,
) -> Result<tipos::Ticket, ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::PATCH,
&format!("/ticket/{}", 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 = "Exclui um ticket pelo id\n\nExige a permissão `deletar` na área `tickets`. Exclusão lógica. As tarefas criadas a partir do ticket continuam nos projetos.\n\n`DELETE /ticket/{id}`"]
pub async fn deletar_pelo_id_ticket(
credencial_de_acesso: &CredencialDeAcesso,
id: uuid::Uuid,
) -> Result<(), ErroAoChamarServico> {
RequisicaoAoServico::nova_requisicao(
&SERVICO_DESTA_API,
Method::DELETE,
&format!("/ticket/{}", codificar_parametro_de_caminho(id)),
)
.com_credencial_de_acesso(credencial_de_acesso)
.enviar_e_ignorar_corpo_da_resposta()
.await
}