【Go】簡単なREST APIサーバーのサンプルコード

概要

Go標準ライブラリのnet/httpパッケージを使って、3つの簡単なAPIエンドポイントのサンプルコード。

• /hello : 固定の文字列を返すGETエンドポイント
• /echo : 受け取ったデータをそのまま返すPOSTエンドポイント
• /json : JSON形式のレスポンスを返すGETエンドポイント

サンプルコード

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

// GET /hello
func helloHandler(w http.ResponseWriter, r *http.Request) {
	if r.Method != http.MethodGet {
		http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
		return
	}
	fmt.Fprintln(w, "Hello, World!")
}

// POST /echo
func echoHandler(w http.ResponseWriter, r *http.Request) {
	if r.Method != http.MethodPost {
		http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
		return
	}

	body, err := io.ReadAll(r.Body)
	if err != nil {
		http.Error(w, "Failed to read body", http.StatusInternalServerError)
		return
	}
	defer r.Body.Close()

	w.Write(body)
}

// GET /json
func jsonHandler(w http.ResponseWriter, r *http.Request) {
	if r.Method != http.MethodGet {
		http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
		return
	}

	// レスポンス用の構造体
	type Response struct {
		Message string `json:"message"`
		Status  string `json:"status"`
	}

	resp := Response{
		Message: "Hello, JSON!",
		Status:  "success",
	}

	// JSONヘッダーをセット
	w.Header().Set("Content-Type", "application/json")

	// JSONエンコードしてレスポンス
	if err := json.NewEncoder(w).Encode(resp); err != nil {
		http.Error(w, "Failed to encode JSON", http.StatusInternalServerError)
	}
}

func main() {
	http.HandleFunc("/hello", helloHandler)
	http.HandleFunc("/echo", echoHandler)
	http.HandleFunc("/json", jsonHandler)

	fmt.Println("🚀 サーバー起動: http://localhost:8080")
	http.ListenAndServe(":8080", nil)
}

解説

• http.HandleFunc

  → 特定のパスにハンドラ関数を紐付ける。

• http.ListenAndServe

  → 指定のポートでHTTPサーバーを起動する。

• r.Method

  → リクエストのHTTPメソッド（GET / POST など）を取得し、適切な処理を分岐する。

• io.ReadAll(r.Body)

  → リクエストボディの内容をすべて読み込む。

• w.Header().Set("Content-Type", "application/json")

  → レスポンスヘッダにContent-Typeを指定する。

• json.NewEncoder(w).Encode(構造体)

  → 構造体の内容をJSON形式に変換し、そのままレスポンスとして返す。