# Como integrar a API de CPF em Go: Guia prático > Aprenda a integrar uma API de consulta de CPF em Go (Golang) usando net/http e Resty. Passo a passo com exemplos de código! **Publicado:** 08/10/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/integrar-api-cpf-go --- Integrar a API de CPF da CPFHub.io em Go é direto: basta uma chamada GET com o header `x-api-key` usando o pacote nativo `net/http`, e você obtém nome, data de nascimento e gênero do titular em aproximadamente 900ms. Este guia mostra o passo a passo completo para ter a validação de CPF funcionando em produção com Go (Golang) em menos de 30 minutos. ## Introdução A integração de uma **API de consulta de CPF** em aplicações desenvolvidas com **Go (Golang)** é essencial para empresas que precisam validar a identidade de clientes de forma rápida e segura. Essa funcionalidade é crucial para fintechs, bancos digitais, e-commerces e outras empresas que lidam com transações financeiras e cadastro de usuários. Este guia demonstra como integrar a CPFHub.io em Go, utilizando a biblioteca `net/http` para fazer chamadas HTTP, garantindo que sua aplicação possa realizar consultas de CPF em tempo real de maneira eficiente e segura. A CPFHub.io oferece suporte a mais de 13 linguagens de programação, incluindo Go, com tempo de resposta de aproximadamente 900ms. --- ## 1. Pré-requisitos Antes de iniciar, certifique-se de que você tem: - **Go instalado** (versão 1.18 ou superior recomendada). - **Conta na CPFHub.io** para obter a chave de API (plano gratuito com 50 consultas/mês, sem necessidade de cartão). - **Conhecimento básico sobre requisições HTTP em Go**. Se ainda não tem uma conta, cadastre-se em [**CPFHub.io**](https://www.cpfhub.io/) e gere sua API key gratuitamente no painel, sem precisar informar cartão de crédito. --- ## 2. Criando um projeto em Go Crie um diretório para seu projeto e inicialize um módulo Go: ```bash mkdir cpf_consulta cd cpf_consulta go mod init cpf_consulta ``` --- ## 3. Instalando dependências O Go já possui suporte nativo para requisições HTTP com o pacote `net/http`, mas recomendamos a instalação do pacote `github.com/go-resty/resty/v2` para facilitar a manipulação de APIs. Para instalar, execute: ```bash go get github.com/go-resty/resty/v2 ``` --- ## 4. Fazendo uma consulta de CPF com Go Aqui está um exemplo de como consultar um CPF utilizando a API da CPFHub.io com `net/http`. ### Usando net/http ```go package main import ( "encoding/json" "fmt" "io/ioutil" "net/http" ) const apiKey = "SUA_CHAVE_DE_API" const cpf = "12345678900" const apiURL = "https://api.cpfhub.io/cpf/" + cpf type CpfResponse struct { Success bool `json:"success"` Data struct { CPF string `json:"cpf"` Name string `json:"name"` NameUpper string `json:"nameUpper"` Gender string `json:"gender"` BirthDate string `json:"birthDate"` Day int `json:"day"` Month int `json:"month"` Year int `json:"year"` } `json:"data"` } func main() { req, _ := http.NewRequest("GET", apiURL, nil) req.Header.Set("x-api-key", apiKey) req.Header.Set("Accept", "application/json") client := &http.Client{} resp, err := client.Do(req) if err != nil { fmt.Println("Erro na requisição:", err) return } defer resp.Body.Close() body, _ := ioutil.ReadAll(resp.Body) var cpfResponse CpfResponse json.Unmarshal(body, &cpfResponse) if cpfResponse.Success { fmt.Println("CPF Válido:", cpfResponse.Data.Name) fmt.Println("Gênero:", cpfResponse.Data.Gender) fmt.Println("Data de nascimento:", cpfResponse.Data.BirthDate) } else { fmt.Println("Erro na consulta de CPF") } } ``` ### Usando Resty (alternativa simplificada) ```go package main import ( "fmt" "github.com/go-resty/resty/v2" ) func main() { client := resty.New() response, err := client.R(). SetHeader("x-api-key", "SUA_CHAVE_DE_API"). SetHeader("Accept", "application/json"). Get("https://api.cpfhub.io/cpf/12345678900") if err != nil { fmt.Println("Erro na consulta:", err) return } fmt.Println("Resposta da API:", response) } ``` --- ## 5. Exemplo de resposta da API ```json { "success": true, "data": { "cpf": "12345678900", "name": "João da Silva", "nameUpper": "JOÃO DA SILVA", "gender": "M", "birthDate": "15/06/1990", "day": 15, "month": 6, "year": 1990 } } ``` --- ## Perguntas frequentes ### O que é necessário para implementar validação de CPF neste contexto? A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em aproximadamente 900ms, permitindo a verificação em tempo real durante o cadastro ou transação. ### A API CPFHub.io funciona para todos os volumes de consulta? Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional. ### Como garantir conformidade com a LGPD ao usar uma API de CPF? Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A [ANPD](https://www.gov.br/anpd/) orienta que dados de identificação devem ser tratados com o princípio da necessidade. ### Quanto tempo leva para integrar a API CPFHub.io? A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key`. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens. ### Leia também - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) - [Onboarding digital em fintechs: como validar CPF em menos de 30 segundos](https://cpfhub.io/blog/onboarding-digital-em-fintechs-como-validar-cpf-em-menos-de-30-segundos) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) --- ## Conclusão Integrar a **API de consulta de CPF** em **Go** é um processo simples e eficiente, proporcionando mais segurança e agilidade na validação de identidade. Utilizando `net/http` ou `resty`, sua aplicação pode realizar consultas em tempo real com tempo de resposta de aproximadamente 900ms, garantindo conformidade com regulamentações como a LGPD e reduzindo riscos de fraude. Se sua empresa deseja uma solução confiável para validação de CPF em Go, a CPFHub.io oferece documentação completa, plano gratuito para testes e escalabilidade automática para produção. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e comece hoje mesmo.