Como Criar uma API REST com Golang e Gin - Parte 1: Introdução

Nesta série de tutoriais, você aprenderá a criar uma API REST completa usando Golang e o framework Gin. Vamos do zero até uma API pronta para produção.

Por que Gin?

O Gin é um dos frameworks web mais populares para Golang:

• ⚡ Performance: uma das bibliotecas mais rápidas (baseada no httprouter)
• 🪶 Leve: apenas ~20KB, sem dependências pesadas
• 📖 Simples: API clean e fácil de aprender
• 🛡️ Maduro: usado em produção por muitas empresas

Pré-requisitos

• Golang 1.21+ instalado (download aqui)
• Conhecimento básico de Go (variáveis, funções, structs)
• Terminal e um editor de código (VS Code recomendado)

Passo 1: Criar o Projeto

mkdir golang-api-gin
cd golang-api-gin
go mod init github.com/seuusuario/golang-api-gin

Passo 2: Instalar o Gin

go get -u github.com/gin-gonic/gin

Passo 3: Primeiro Endpoint

Crie um arquivo main.go:

package main

import "github.com/gin-gonic/gin"

func main() {
    // Cria uma instância do Gin no modo release
    r := gin.Default()

    // Endpoint GET /ping
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })

    // Inicia o servidor na porta 8080
    r.Run(":8080")
}

Passo 4: Executar

go run main.go

Acesse: http://localhost:8080/ping

Resposta esperada:

{"message": "pong"}

Estrutura do Projeto (Final)

golang-api-gin/
├── main.go
├── go.mod
├── go.sum
└── handlers/
    └── (vamos criar na Parte 2)

Próximos Passos

Na Parte 2, vamos:

• Criar os handlers organizados
• Definir as rotas da nossa API (CRUD de livros)
• Implementar GET, POST, PUT, DELETE

👉 Parte 2: Estruturando os Handlers

Gostou deste tutorial? Compartilhe no Twitter e deixe seu feedback no Telegram!