Hızlı Başlangıç

Gin hızlı başlangıç rehberine hoş geldiniz! Bu kılavuz, Gin’i kurma, bir proje oluşturma ve ilk API’nizi çalıştırma adımlarında size yol gösterir; böylece güvenle web servisleri oluşturmaya başlayabilirsiniz.

Ön Koşullar

• Go sürümü: Gin, Go sürüm 1.25 veya üstünü gerektirir
• Go’nun PATH’inizde olduğunu ve terminalinizden kullanılabilir olduğunu doğrulayın. Go kurulumu için resmi dokümanlara bakın.

---

Adım 1: Gin’i Kurun ve Projenizi Başlatın

Yeni bir proje klasörü oluşturarak ve bir Go modülü başlatarak başlayın:

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

Gin’i bağımlılık olarak ekleyin:

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

---

Adım 2: İlk Gin Uygulamanızı Oluşturun

main.go adında bir dosya 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() // listens on 0.0.0.0:8080 by default
}

---

Adım 3: API Sunucunuzu Çalıştırın

Sunucunuzu şu komutla başlatın:

go run main.go

Tarayıcınızda http://localhost:8080/ping adresine gidin, şunu görmelisiniz:

{"message":"pong"}

---

Ek Örnek: net/http ile Gin Kullanımı

Yanıt kodları için net/http sabitlerini kullanmak istiyorsanız, onu da içe aktarın:

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’da yeni misiniz? Go kodu yazmayı ve çalıştırmayı resmi Go dokümantasyonunda öğrenin.

• Gin kavramlarını uygulamalı olarak pratik yapmak mı istiyorsunuz? Etkileşimli alıştırmalar ve eğitimler için Öğrenme Kaynakları sayfamıza göz atın.

• Tam özellikli bir örneğe mi ihtiyacınız var? Şununla hızlıca başlayın:

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

• Daha ayrıntılı dokümantasyon için Gin kaynak kodu dokümanlarını ziyaret edin.