Pular para o conteúdo principal

Criar radar de novos processos

POST 
/v1/monitoramentos/novos-processos

Cria radar por termo para localizar novos processos. termo é obrigatório, variacoes aceita no máximo dois itens, termos_auxiliares usam condições CONTEM, NAO_CONTEM ou CONTEM_ALGUMA e webhook_url deve ser HTTPS. O radar gera cobrança recorrente enquanto ativo e pode entregar eventos de novo processo no webhook configurado.

Valor para a operação: automatiza a descoberta de novos processos por termo e transforma resultados em oportunidades de análise e qualificação.

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​

Resposta da operação.

Callbacks​

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​

Evento recebido pelo cliente.