Skip to main content

​
📬 Receber Mensagens

Este endpoint permite consumir mensagens da sua fila exclusiva contendo os resultados das buscas de monitoramento. Mensagens não confirmadas voltam a ficar disponíveis após 30 segundos.

​
🔗 Endpoint

GET https://api.predictus.com.br/predictus-api/monitoramento/mensagens?limite=10

​
📚 Parâmetros

ParâmetroObrigatórioDefaultMinMaxDescrição
limiteNão10110Quantidade máxima de mensagens a receber

​
📥 Exemplo de cURL

curl --location 'https://api.predictus.com.br/predictus-api/monitoramento/mensagens?limite=10' \
--header 'Authorization: Bearer {accessToken}'

​
✅ Resposta esperada (200)

[
  {
    "mensagemId": "abc123",
    "recibo": "AQEBwJnK...",
    "conteudo": {
      "termoId": "550e8400-e29b-41d4-a716-446655440000",
      "tipoTermo": "CPF",
      "valorTermo": "12345678901",
      "periodicidade": "DIARIO",
      "dataBuscaDe": "2026-03-29",
      "dataBuscaAte": "2026-04-05",
      "resultados": [ "...detalhes dos processos..." ]
    }
  }
]

​
📚 Campos da resposta

CampoTipoDescrição
mensagemIdstringIdentificador único da mensagem
recibostringToken de recibo — deve ser guardado para confirmar o recebimento
conteudo.termoIdUUIDID do termo que gerou o resultado
conteudo.tipoTermostringTipo do termo: CPF, CNPJ ou CNPJ_RAIZ
conteudo.valorTermostringValor do documento monitorado
conteudo.periodicidadestringPeriodicidade configurada no termo
conteudo.dataBuscaDedateInício do período da busca
conteudo.dataBuscaAtedateFim do período da busca
conteudo.resultadosarrayLista de processos encontrados

​
🧾 Códigos de resposta

CódigoSignificado
200Mensagens recebidas com sucesso
401Token inválido ou expirado

​
💡 Dicas

O campo recibo deve ser guardado para confirmar o recebimento da mensagem via o endpoint Confirmar Recebimento.
Mensagens não confirmadas voltam a ficar disponíveis após 30 segundos. Isso garante que nenhuma mensagem seja perdida caso ocorra uma falha no processamento do lado do cliente.
Se houver mais de 10 mensagens pendentes, faça múltiplas chamadas até receber uma resposta vazia.