Guia Rápido

Bem-vindo ao Guia Rápido do Gin! Este guia mostra passo a passo como instalar o Gin, configurar seu projeto e executar sua primeira API – tornando fácil começar no desenvolvimento de serviços web.

Pré-requisitos

• Go: versão 1.23 ou superior instalada.
• Garanta que o Go está no seu PATH e pode ser usado no terminal. Para saber como instalar, veja a documentação oficial.

---

Passo 1: Instale o Gin e inicialize o projeto

Comece criando uma pasta para o projeto e inicialize o módulo Go:

mkdir gin-quickstart && cd gin-quickstart
go mod init gin-quickstart

Adicione o Gin como dependência:

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

---

Passo 2: Crie sua primeira aplicação com Gin

Crie um arquivo chamado main.go:

touch main.go

Abra o main.go e insira o seguinte código:

package main

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

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(200, gin.H{
      "message": "pong",
    })
  })
  router.Run() // escuta em 0.0.0.0:8080 por padrão
}

---

Passo 3: Execute o servidor API

Inicie o servidor executando:

go run main.go

Abra http://localhost:8080/ping em seu navegador e deverá ver:

{"message":"pong"}

---

Exemplo adicional: Usando net/http com Gin

Caso deseje usar constantes da biblioteca net/http para os códigos de resposta, importe-a também:

package main

import (
  "github.com/gin-gonic/gin"
  "net/http"
)

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
      "message": "pong",
    })
  })
  router.Run()
}

---

Dicas e recursos

• Novo em Go? Aprenda a escrever e executar código Go aqui.

• Precisa de um exemplo mais completo? Use:

  curl https://raw.githubusercontent.com/gin-gonic/examples/master/basic/main.go > main.go

• Para documentação detalhada, acesse os docs oficiais do Gin.