Java
Consulte CPF com java.net.http.HttpClient nativo. Disponível desde Java 11 - sem dependências externas.
Integrando com Cursor, Lovable, v0 ou outra IA?
Copie o prompt de integração e cole direto no seu assistente de IA - ele saberá exatamente como usar a API.
Pré-requisitos
- Java 11+
- Uma API Key em app.cpfhub.io
Exemplo
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class CpfLookup {
public static void main(String[] args) throws Exception {
String cpf = "12345678909";
String apiKey = System.getenv("CPFHUB_API_KEY");
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.cpfhub.io/cpf/" + cpf))
.header("x-api-key", apiKey)
.GET()
.build();
HttpResponse<String> response = client.send(
request,
HttpResponse.BodyHandlers.ofString()
);
if (response.statusCode() != 200) {
throw new RuntimeException("API error: " + response.statusCode());
}
System.out.println(response.body());
// {"data":{"cpf":"12345678909","name":"Fulano de Tal",...}}
}
}Com Jackson (parsing do JSON)
Java
// pom.xml: com.fasterxml.jackson.core:jackson-databind:2.16.1
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(response.body());
JsonNode data = root.get("data");
System.out.println(data.get("name").asText()); // "Fulano de Tal"
System.out.println(data.get("birthDate").asText()); // "15/06/1990"
System.out.println(data.get("gender").asText()); // "M"Campos retornados
| Campo JSON | Tipo Java | Exemplo |
|---|---|---|
cpf | String | "12345678909" |
name | String | "Fulano de Tal" |
nameUpper | String | "FULANO DE TAL" |
gender | String | "M" |
birthDate | String | "15/06/1990" |
day | int | 15 |
month | int | 6 |
year | int | 1990 |
Tratamento de erros
| HTTP | error.code | Descrição |
|---|---|---|
| 404 | CPF_NOT_FOUND | CPF não consta na base |
| 422 | INVALID_CPF_DIGITS | Dígitos verificadores inválidos |
| 429 | RATE_LIMIT_EXCEEDED | Muitas requisições |
| 401 | UNAUTHORIZED | API Key inválida ou ausente |
Links
Atualizado em 17 de maio de 2026