Consultar processos por API
Consulte os processos do seu escritório, combine filtros e percorra as páginas sem confundir acesso à API com consulta irrestrita a tribunais.
Quais processos posso consultar?
GET /v2/processos lista os processos disponíveis no contexto do escritório identificado por X-API-Key. A chave não seleciona outro escritório e esta operação não deve ser interpretada como uma consulta irrestrita de qualquer número CNJ nos tribunais.
Comece pela primeira requisição e consulte os parâmetros completos em Processos.
Combine os filtros da consulta
Os filtros são combinados por E. q procura pelo início do número do processo, com ou sem máscara. cpfCnpjCliente faz correspondência exata do documento do cliente. encerrado e monitoramentoAtivo são independentes: omitir um deles não restringe esse estado.
Use dados do seu próprio contexto. O número e os documentos dos exemplos são ilustrativos.
curl --request GET \
--url 'https://api.expedit.com.br/v2/processos?encerrado=false&monitoramentoAtivo=true&page=1&perPage=15' \
--header "X-API-Key: ${EXPEDIT_API_KEY}" \
--header 'Accept: application/json'Faça uma consulta com Java
O exemplo usa o cliente HTTP do JDK 11 ou superior, sem framework adicional. Configure EXPEDIT_API_KEY no ambiente do processo backend. O timeout limita a espera; um status de erro deve ser tratado conforme a operação.
response.body() contém o JSON para o parser já usado pelo seu projeto. Não registre a chave ou o corpo completo de processos em logs de produção.
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
class ConsultaProcessos {
public static void main(String[] args) throws Exception {
String key = System.getenv("EXPEDIT_API_KEY");
if (key == null || key.isBlank()) {
throw new IllegalStateException("Configure EXPEDIT_API_KEY");
}
var client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10)).build();
var request = HttpRequest.newBuilder(URI.create(
"https://api.expedit.com.br/v2/processos?page=1&perPage=15"))
.timeout(Duration.ofSeconds(30))
.header("X-API-Key", key)
.header("Accept", "application/json")
.GET().build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() < 200 || response.statusCode() >= 300) {
throw new IllegalStateException("HTTP " + response.statusCode());
}
System.out.println("HTTP " + response.statusCode());
}
}Percorra a coleção por páginas
A página inicial é 1. Leia content, page, perPage, total e totalPages do envelope recebido; avance enquanto houver páginas, sem inferir o fim apenas pelo tamanho de content.
O tamanho padrão é 15 e o teto é 100 itens para esta consulta. Os resultados podem mudar entre chamadas se os dados forem atualizados; paginação não equivale a uma captura imutável. Veja Paginação e filtros.
Trate falhas sem repetir alterações
Uma consulta pode retornar uma coleção vazia sem erro. Para 401, confira validade e ambiente da chave; para 429, respeite Retry-After quando presente. Use timeout e um limite de tentativas no seu cliente.
O guia de erros diferencia falhas de autenticação, permissões e indisponibilidade. Para consultar dados relacionados, escolha a operação específica na referência de Processos, em vez de presumir que a listagem contém todos os detalhes.