Hızlı Başlangıç

Gin Hızlı Başlangıç rehberine hoş geldiniz! Bu rehberde Gin’in kurulumu, projenizin yapılandırılması ve ilk API’nizin çalıştırılması adımlarını kolay anlaşılır şekilde öğrenecek, web servislerinizi güvenle inşa edebileceksiniz.

Ön Gereksinimler

Go: 1.23 veya üzeri bir sürüm kurulu olmalıdır.
Go’nun PATH’inize ekli olduğundan ve terminalden çalıştığından emin olun. Kurulum için resmi belgeleri inceleyin.

Adım 1: Gin’i Kur ve Projeni Başlat

Yeni bir proje dizini oluşturup Go modülünü başlatın:

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

Gin’i projeye ekleyin:

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

Adım 2: İlk Gin Uygulamanı Oluştur

main.go dosyasını oluşturun:

touch main.go

main.go dosyasını açın ve aşağıdaki kodu ekleyin:

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() // varsayılan olarak 0.0.0.0:8080’de dinler
}

Adım 3: API Sunucunu Çalıştır

Sunucuyu başlatmak için:

go run main.go

Tarayıcıda http://localhost:8080/ping adresine git ve aşağıdaki çıktıyı görmelisin:

{"message":"pong"}

Ekstra Örnek: Gin ile net/http Kullanmak

Yanıt kodlarını belirlemek için net/http sabitlerini kullanmak istersen, onu da ekleyebilirsin:

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()
}

İpuçları ve Kaynaklar

Go’ya yeni misin? Go kodu yazmayı ve çalıştırmayı buradan öğrenebilirsin.

Daha kapsamlı bir örnek için şu komutu kullanabilirsin:

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

Daha ayrıntılı belge için Gin kaynak kodu dokümantasyonu adresini incele.