Como integrar a API de CPF em Go: Guia prático

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 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:

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:

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

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)

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

{
    "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 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.

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 — 50 consultas mensais gratuitas, sem cartão de crédito — e comece hoje mesmo.