syntax = "v1"

// 業務 data（Logic returns 型別；HTTP 外層 envelope 見 @respdoc）
type PingData {
	Pong string `json:"pong"`
}

// 文件用：成功回應 envelope（code=0, message=SUCCESS, data=PingData）
type PingOKStatus {
	Code    int64    `json:"code"`
	Message string   `json:"message"`
	Data    PingData `json:"data"`
}

@server(
	group:   normal
	prefix:  /api/v1
	schemes: https
	timeout: 3s
)
service gateway {
	@doc(
		summary:     "Ping"
		description: "確認伺服器狀態"
	)
	/*
		@respdoc-200 (PingOKStatus) // 成功
		@respdoc-400 (APIErrorStatus) // 參數錯誤（如 httpx.Parse / 驗證失敗）
		@respdoc-500 (APIErrorStatus) // 系統內部錯誤
	*/
	@handler ping
	get /health () returns (PingData)
}