コンテンツにスキップ
Gin Web Framework

クイックスタート

Ginクイックスタートガイドへようこそ！このガイドでは、Ginのインストール、プロジェクトの設定、最初のAPIを作成する手順を分かりやすく紹介します。これにより、安心してWebサービスを構築できます。

必要条件

  • Go: バージョン1.23以上がインストールされている必要があります。
  • GoがあなたのPATHに含まれ、ターミナルから使用できることを確認してください。インストールに困った場合は公式ドキュメントをご覧ください。

ステップ1: Ginのインストールとプロジェクトの初期化

まず、新しいプロジェクトフォルダを作成し、Goモジュールを初期化します：

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

Ginパッケージを依存関係に追加します：

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

ステップ2: Ginアプリの作成

main.goというファイルを作成します：

Terminal window
touch main.go

main.goを開いて、次のコードを追加してください：

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() // デフォルトで0.0.0.0:8080で待機します
}

ステップ3: APIサーバの起動

次のコマンドでサーバを起動します：

Terminal window
go run main.go

ブラウザでhttp://localhost:8080/pingにアクセスすると、以下が表示されます：

{"message":"pong"}

追加例: Ginでnet/httpを使う

レスポンスコードにnet/httpの定数を使いたい場合は、インポートしてください：

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

ヒント & リソース

  • Goの初心者ですか？Goコードの書き方と実行方法はこちら。

  • もっと詳しいサンプルが必要なら、次のコマンドを使用してください：

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

  • 詳しいドキュメントはGin公式ドキュメントをご覧ください。