Canal público
Endpoints usados pela página pública do canal: envio de relato, acompanhamento por protocolo e chave.
Confirmar e-mail de aviso
Quem recebeu o link de confirmação confirma o e-mail externo para passar a receber avisos, enviando o `token` do link. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Link inválido ou expirado responde `404`.
Sair dos avisos por e-mail
Quem recebe avisos em um e-mail externo deixa de recebê-los, pelo `token` do link presente em todo aviso. Os avisos na fila são cancelados e quem gerencia automações é avisado. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Link inválido responde `404`.
Consultar organização no canal público
Retorna o nome e a descrição da organização e os canais de denúncia listados publicamente, com as empresas atendidas. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Organização inexistente ou inativa responde `404`.
Consultar canal público
Retorna o canal com instruções, modos de identificação aceitos, empresas atendidas e as categorias com o formulário que quem relata preenche. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Organização ou canal inexistente responde `404`.
Enviar relato
Registra um relato no canal e responde `201` com o protocolo e a chave de acesso, exibida só nesta resposta. É idempotente por `attempt_secret`: uma repetição devolve o mesmo protocolo e não cria nada. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Canal fechado responde `409`; modo de identificação, empresa ou formulário inválidos, `422`.
Acessar relato com protocolo e chave
Abre a sessão de acompanhamento de um relato com `protocol` e `key` e retorna um `token` de curta duração. Qualquer falha responde o mesmo `404`; as tentativas são limitadas por endereço e por protocolo (`429`). Rota pública, sem autenticação.
Encerrar sessão do relato
Encerra a sessão de acompanhamento do relato informada no cabeçalho `Authorization: Bearer` e responde `204`. Rota pública, sem autenticação adicional.
Consultar relato
Retorna o andamento do relato para quem relatou: protocolo, categoria escolhida, etapa atual, linha do tempo, resposta pendente e conclusão, quando houver. Exige o token de sessão aberto pelo acesso com protocolo e chave no cabeçalho `Authorization: Bearer`; sessão ausente, expirada ou revogada responde `401`.
Listar mensagens do relato
Lista as mensagens públicas trocadas entre quem relatou e a equipe, a partir da sequência `after`, com até `limit` itens (máximo 200). Exige o token de sessão aberto pelo acesso com protocolo e chave no cabeçalho `Authorization: Bearer`; sessão ausente, expirada ou revogada responde `401`.
Enviar mensagem no relato
Envia uma mensagem de quem relatou à equipe (até 4000 caracteres) e responde `201`; se houver uma resposta pendente solicitada pela equipe, ela é registrada como respondida. Exige o token de sessão aberto pelo acesso com protocolo e chave no cabeçalho `Authorization: Bearer`; sessão ausente, expirada ou revogada responde `401`. Relato encerrado responde `409`; limitado a 30 mensagens por hora (`429`).
Consultar avisos por e-mail do relato
Informa se os avisos de atualização por e-mail estão ligados para o relato. O endereço nunca é retornado. Exige o token de sessão aberto pelo acesso com protocolo e chave no cabeçalho `Authorization: Bearer`; sessão ausente, expirada ou revogada responde `401`.
Definir avisos por e-mail do relato
Liga os avisos de atualização por e-mail informando um endereço ou desliga com `email: null`. O endereço é guardado cifrado e a equipe não o vê. Exige o token de sessão aberto pelo acesso com protocolo e chave no cabeçalho `Authorization: Bearer`; sessão ausente, expirada ou revogada responde `401`. Limitado a 10 alterações por hora (`429`).
Abrir envio de evidências
Abre (ou reaproveita) o contexto de envio de evidências desta tentativa de relato e informa os limites: até 10 arquivos, 10 MiB cada, PDF, PNG ou JPEG. Só quem tem o `attempt_secret` pode anexar, e o envio do relato consome o contexto. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Canal fechado ou formulário alterado responde `409`.
Anexar evidência
Envia um arquivo (PDF, PNG ou JPEG, identificado pelo conteúdo) junto com o `attempt_secret` no formulário. O arquivo é guardado cifrado e fica em quarentena: ninguém o baixa até a verificação de segurança concluir que está limpo. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`). Responde `201` com o estado da verificação.
Iniciar recuperação da chave
Inicia a recuperação da chave de acesso de um relato identificado por `protocol` e e-mail de recuperação. A resposta é sempre a mesma (`202`) e nunca revela se o protocolo ou o e-mail existem; o código só é enviado quando o e-mail pertence ao protocolo. Relatos anônimos não têm recuperação. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`).
Concluir recuperação da chave
Confirma o código recebido por e-mail e retorna uma nova chave de acesso, exibida uma única vez; a chave antiga e todas as sessões abertas deixam de funcionar. Códigos errados consomem um pequeno limite de tentativas e depois o código é invalidado. Qualquer falha responde `404`. Rota pública do canal, sem autenticação, com limite de requisições por endereço (`429`).