Skip to main content

​
📝 Cadastrar Termo

Este endpoint permite cadastrar um novo termo de monitoramento. Ao criar o termo, uma busca imediata é disparada em segundo plano. Se houver processos nos últimos 7 dias, os resultados já estarão disponíveis na fila de mensagens em poucos minutos.

​
🔗 Endpoint

POST https://api.predictus.com.br/predictus-api/monitoramento/termos

​
🧾 Corpo da requisição

{
  "tipoTermo": "CPF",
  "termo": "12345678901",
  "periodicidade": "DIARIO"
}

​
📚 Campos

CampoObrigatórioTipoDescrição
tipoTermoSimstringTipo do documento: CPF, CNPJ ou CNPJ_RAIZ
termoSimstringValor do documento a ser monitorado (8 a 14 caracteres alfanuméricos)
periodicidadeSimstringFrequência das buscas: DIARIO, SEMANAL, QUINZENAL, MENSAL ou TRIMESTRAL

​
🛡️ Validações

TipoRegra
CPFExatamente 11 dígitos numéricos
CNPJExatamente 14 caracteres alfanuméricos
CNPJ_RAIZExatamente 8 caracteres alfanuméricos

​
📥 Exemplo de cURL

curl --location 'https://api.predictus.com.br/predictus-api/monitoramento/termos' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {accessToken}' \
--data '{
  "tipoTermo": "CPF",
  "termo": "12345678901",
  "periodicidade": "DIARIO"
}'

​
✅ Resposta esperada (201)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "tipoTermo": "CPF",
  "termo": "12345678901",
  "periodicidade": "DIARIO",
  "criadoEm": "2026-04-05T10:30:00"
}

​
🧾 Códigos de resposta

CódigoSignificado
201Termo criado com sucesso
401Token inválido ou expirado
409Termo já existe para este cliente
500Erro interno do servidor

​
💡 Dica

Ao criar o termo, uma busca imediata é disparada automaticamente. Se houver processos nos últimos 7 dias, os resultados já estarão disponíveis na sua fila de mensagens em poucos minutos — sem precisar esperar a próxima execução programada.