Criar monitoramento de publicações judiciais
POST/v1/monitoramentos/publicacoes
Cria um monitoramento recorrente para STF_DJE, TSE_DJE, TRE_DJE e/ou MURAL_ELEITORAL. Informe ao menos um filtro entre termo, processo ou OAB; para fontes eleitorais, informe de um a cinco tribunais. A primeira mensalidade é debitada na criação: R$ 0,90 para a configuração base e R$ 0,30 por fonte ou tribunal adicional. Novas correspondências geram o evento publicacao_judicial_nova no webhook HTTPS informado.
Valor para a operação: transforma consultas ao STF e à Justiça Eleitoral em vigilância contínua, com deduplicação e entrega imediata por webhook.
Autenticação e resposta: envie a chave em x-api-key ou Authorization: Bearer. Os exemplos mostram uma resposta típica; campos adicionais podem aparecer conforme o tipo de consulta. meta pode conter creditsCharged, creditsRemaining, requestId e searchLogId. Trate erros pelo status HTTP e por error.code.
SLA e HTTP 202: a API reserva uma janela total de até 30 segundos para responder. Quando uma consulta elegível não termina com segurança nessa janela, o trabalho continua no servidor e a resposta é HTTP 202, sem débito adicional naquele estado pendente. Siga o header Location ou data.statusUrl com a mesma API key; Retry-After, pollAfterSeconds, pollAfterMs e nextPollAt informam quando tentar novamente. Pare o polling quando receber um status diferente de 202. A URL de status reproduz a resposta final sem executar nem cobrar a operação novamente.
Requisição
Responses
- 200
- 201
- 202
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Resposta da operação.
Recurso criado com sucesso.
A operação ultrapassou a janela síncrona e continua no servidor. Faça polling da URL informada.
Response Headers
URL absoluta de acompanhamento.
Espera mínima recomendada antes do próximo polling, em segundos.
JSON inválido ou parâmetros ausentes/inválidos.
API key ausente ou inválida.
Conta inativa, saldo insuficiente ou operação não permitida.
Recurso não encontrado.
Parâmetros válidos sintaticamente, mas rejeitados por regra de negócio.
Limite de requisições excedido. A API aplica limites por classe de rota.
Erro interno não especificado.
Callbacks
- POST webhook
POST{$request.body#/webhook_url}
A BuscaProcessos envia POST JSON para a webhook_url configurada. Use Content-Type application/json, responda com HTTP 2xx rapidamente e processe o trabalho pesado em fila. O envio inclui X-BuscaProcessos-Event, X-BuscaProcessos-Delivery-Id e X-BuscaProcessos-Timestamp; quando o segredo estiver configurado, inclui X-BuscaProcessos-Signature no formato sha256=HMAC-SHA256(payload).
Callbacks Responses
- 2XX
- 4XX
- 5XX
Evento recebido pelo cliente.
O cliente rejeitou o evento; a entrega pode ser marcada como falha.
O cliente não processou o evento; a entrega pode ser reprocessada.