컨텐츠로 건너뛰기
Gin Web Framework

헤더 바인딩

ShouldBindHeader는 header 구조체 태그를 사용하여 HTTP 요청 헤더를 구조체에 직접 바인딩합니다. API 요청 제한, 인증 토큰 또는 커스텀 도메인 헤더와 같은 메타데이터를 수신 요청에서 추출하는 데 유용합니다.

package main


import (
  "net/http"


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


type testHeader struct {
  Rate   int    `header:"Rate"`
  Domain string `header:"Domain"`
}


func main() {
  r := gin.Default()


  r.GET("/", func(c *gin.Context) {
    h := testHeader{}


    if err := c.ShouldBindHeader(&h); err != nil {
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }


    c.JSON(http.StatusOK, gin.H{"Rate": h.Rate, "Domain": h.Domain})
  })


  r.Run(":8080")
}

테스트

Terminal window
# Pass custom headers
curl -H "Rate:300" -H "Domain:music" http://localhost:8080/
# Output: {"Domain":"music","Rate":300}


# Missing headers -- zero values are used
curl http://localhost:8080/
# Output: {"Domain":"","Rate":0}

참고