commit 96711ffb35400c508196f25c63eb1f594843e6e2 Author: xieyao <1297754537@qq.com> Date: Wed Apr 1 06:48:29 2026 +0000 feat: initial FRED API Proxy project - Go web server using Gin framework - Proxy FRED economic data API - Support series, observations, search, releases endpoints diff --git a/config/config.go b/config/config.go new file mode 100644 index 0000000..ed0a5e8 --- /dev/null +++ b/config/config.go @@ -0,0 +1,34 @@ +package config + +import ( + "os" +) + +type Config struct { + FREDAPIKey string + ServerPort string + FREDBaseURL string +} + +func Load() *Config { + apiKey := os.Getenv("FRED_API_KEY") + if apiKey == "" { + apiKey = "987b9c3428a3d0fe90179e3e6298d05e" + } + + port := os.Getenv("SERVER_PORT") + if port == "" { + port = "8080" + } + + baseURL := os.Getenv("FRED_BASE_URL") + if baseURL == "" { + baseURL = "https://api.stlouisfed.org/fred" + } + + return &Config{ + FREDAPIKey: apiKey, + ServerPort: port, + FREDBaseURL: baseURL, + } +} diff --git a/fred-api b/fred-api new file mode 100755 index 0000000..d89683d Binary files /dev/null and b/fred-api differ diff --git a/go.mod b/go.mod new file mode 100644 index 0000000..a28dca6 --- /dev/null +++ b/go.mod @@ -0,0 +1,35 @@ +module fred-api + +go 1.21 + +require ( + github.com/gin-gonic/gin v1.9.1 + github.com/joho/godotenv v1.5.1 +) + +require ( + github.com/bytedance/sonic v1.9.1 // indirect + github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 // indirect + github.com/gabriel-vasile/mimetype v1.4.2 // indirect + github.com/gin-contrib/sse v0.1.0 // indirect + github.com/go-playground/locales v0.14.1 // indirect + github.com/go-playground/universal-translator v0.18.1 // indirect + github.com/go-playground/validator/v10 v10.14.0 // indirect + github.com/goccy/go-json v0.10.2 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/klauspost/cpuid/v2 v2.2.4 // indirect + github.com/leodido/go-urn v1.2.4 // indirect + github.com/mattn/go-isatty v0.0.19 // indirect + github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/pelletier/go-toml/v2 v2.0.8 // indirect + github.com/twitchyliquid64/golang-asm v0.15.1 // indirect + github.com/ugorji/go/codec v1.2.11 // indirect + golang.org/x/arch v0.3.0 // indirect + golang.org/x/crypto v0.9.0 // indirect + golang.org/x/net v0.10.0 // indirect + golang.org/x/sys v0.8.0 // indirect + golang.org/x/text v0.9.0 // indirect + google.golang.org/protobuf v1.30.0 // indirect + gopkg.in/yaml.v3 v3.0.1 // indirect +) diff --git a/go.sum b/go.sum new file mode 100644 index 0000000..f7dd2cc --- /dev/null +++ b/go.sum @@ -0,0 +1,88 @@ +github.com/bytedance/sonic v1.5.0/go.mod h1:ED5hyg4y6t3/9Ku1R6dU/4KyJ48DZ4jPhfY1O2AihPM= +github.com/bytedance/sonic v1.9.1 h1:6iJ6NqdoxCDr6mbY8h18oSO+cShGSMRGCEo7F2h0x8s= +github.com/bytedance/sonic v1.9.1/go.mod h1:i736AoUSYt75HyZLoJW9ERYxcy6eaN6h4BZXU064P/U= +github.com/chenzhuoyu/base64x v0.0.0-20211019084208-fb5309c8db06/go.mod h1:DH46F32mSOjUmXrMHnKwZdA8wcEefY7UVqBKYGjpdQY= +github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 h1:qSGYFH7+jGhDF8vLC+iwCD4WpbV1EBDSzWkJODFLams= +github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311/go.mod h1:b583jCggY9gE99b6G5LEC39OIiVsWj+R97kbl5odCEk= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/gabriel-vasile/mimetype v1.4.2 h1:w5qFW6JKBz9Y393Y4q372O9A7cUSequkh1Q7OhCmWKU= +github.com/gabriel-vasile/mimetype v1.4.2/go.mod h1:zApsH/mKG4w07erKIaJPFiX0Tsq9BFQgN3qGY5GnNgA= +github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE= +github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI= +github.com/gin-gonic/gin v1.9.1 h1:4idEAncQnU5cB7BeOkPtxjfCSye0AAm1R0RVIqJ+Jmg= +github.com/gin-gonic/gin v1.9.1/go.mod h1:hPrL7YrpYKXt5YId3A/Tnip5kqbEAP+KLuI3SUcPTeU= +github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s= +github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= +github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA= +github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY= +github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY= +github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY= +github.com/go-playground/validator/v10 v10.14.0 h1:vgvQWe3XCz3gIeFDm/HnTIbj6UGmg/+t63MyGU2n5js= +github.com/go-playground/validator/v10 v10.14.0/go.mod h1:9iXMNT7sEkjXb0I+enO7QXmzG6QCsPWY4zveKFVRSyU= +github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= +github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= +github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= +github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU= +github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0= +github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.2.4 h1:acbojRNwl3o09bUq+yDCtZFc1aiwaAAxtcn8YkZXnvk= +github.com/klauspost/cpuid/v2 v2.2.4/go.mod h1:RVVoqg1df56z8g3pUjL/3lE5UfnlrJX8tyFgg4nqhuY= +github.com/leodido/go-urn v1.2.4 h1:XlAE/cm/ms7TE/VMVoduSpNBoyc2dOxHs5MZSwAN63Q= +github.com/leodido/go-urn v1.2.4/go.mod h1:7ZrI8mTSeBSHl/UaRyKQW1qZeMgak41ANeCNaVckg+4= +github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA= +github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pelletier/go-toml/v2 v2.0.8 h1:0ctb6s9mE31h0/lhu+J6OPmVeDxJn+kYnJc2jZR9tGQ= +github.com/pelletier/go-toml/v2 v2.0.8/go.mod h1:vuYfssBdrU2XDZ9bYydBu6t+6a6PYNcZljzZR9VXg+4= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= +github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= +github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.3 h1:RP3t2pwF7cMEbC1dqtB6poj3niw/9gnV4Cjg5oW5gtY= +github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= +github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= +github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU= +github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8= +golang.org/x/arch v0.3.0 h1:02VY4/ZcO/gBOH6PUaoiptASxtXU10jazRCP865E97k= +golang.org/x/arch v0.3.0/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8= +golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g= +golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= +golang.org/x/net v0.10.0 h1:X2//UzNDwYmtCLn7To6G58Wr6f5ahEAQgKNzv9Y951M= +golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= +golang.org/x/sys v0.0.0-20220704084225-05e143d24a9e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.8.0 h1:EBmGv8NaZBZTWvrbjNoL6HVt+IVy3QDQpJs7VRIw3tU= +golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/text v0.9.0 h1:2sjJmO8cDvYveuX97RDLsxlyUxLl+GHoLxBiRdHllBE= +golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= +google.golang.org/protobuf v1.30.0 h1:kPPoIgf3TsEvrm0PFe15JQ+570QVxYzEvvHqChK+cng= +google.golang.org/protobuf v1.30.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4= diff --git a/handlers/fred.go b/handlers/fred.go new file mode 100644 index 0000000..9416b50 --- /dev/null +++ b/handlers/fred.go @@ -0,0 +1,291 @@ +package handlers + +import ( + "encoding/json" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + "fred-api/config" + "fred-api/models" + + "github.com/gin-gonic/gin" +) + +type FREDHandler struct { + baseURL string + apiKey string +} + +func NewFREDHandler(cfg *config.Config) *FREDHandler { + return &FREDHandler{ + baseURL: cfg.FREDBaseURL, + apiKey: cfg.FREDAPIKey, + } +} + +func (h *FREDHandler) buildURL(endpoint string, params map[string]string) string { + u, _ := url.Parse(h.baseURL + endpoint) + query := u.Query() + query.Set("api_key", h.apiKey) + query.Set("file_type", "json") + + for k, v := range params { + if v != "" { + query.Set(k, v) + } + } + + u.RawQuery = query.Encode() + return u.String() +} + +func (h *FREDHandler) fetchData(url string, target interface{}) error { + resp, err := http.Get(url) + if err != nil { + return err + } + defer resp.Body.Close() + + body, err := io.ReadAll(resp.Body) + if err != nil { + return err + } + + if resp.StatusCode != http.StatusOK { + var errResp models.ErrorResponse + json.Unmarshal(body, &errResp) + return fmt.Errorf("API error: %s - %s", errResp.ErrorCode, errResp.ErrorMessage) + } + + return json.Unmarshal(body, target) +} + +func (h *FREDHandler) GetSeries(c *gin.Context) { + seriesID := c.Query("series_id") + if seriesID == "" { + c.JSON(http.StatusBadRequest, models.ErrorResponse{ + ErrorCode: "BadRequest", + ErrorMessage: "series_id is required", + }) + return + } + + params := map[string]string{ + "series_id": seriesID, + } + + if realtimeStart := c.Query("realtime_start"); realtimeStart != "" { + params["realtime_start"] = realtimeStart + } + if realtimeEnd := c.Query("realtime_end"); realtimeEnd != "" { + params["realtime_end"] = realtimeEnd + } + + url := h.buildURL("/series", params) + + var response models.SeriesListResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) GetObservations(c *gin.Context) { + seriesID := c.Query("series_id") + if seriesID == "" { + c.JSON(http.StatusBadRequest, models.ErrorResponse{ + ErrorCode: "BadRequest", + ErrorMessage: "series_id is required", + }) + return + } + + params := map[string]string{ + "series_id": seriesID, + } + + optionalParams := []string{ + "realtime_start", "realtime_end", "limit", "offset", "sort_order", + "observation_start", "observation_end", "units", "frequency", + "aggregation_method", "output_type", "vintage_dates", + } + + for _, param := range optionalParams { + if v := c.Query(param); v != "" { + params[param] = v + } + } + + url := h.buildURL("/series/observations", params) + + var response models.ObservationsResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) SearchSeries(c *gin.Context) { + searchText := c.Query("search_text") + if searchText == "" { + c.JSON(http.StatusBadRequest, models.ErrorResponse{ + ErrorCode: "BadRequest", + ErrorMessage: "search_text is required", + }) + return + } + + params := map[string]string{ + "search_text": searchText, + } + + optionalParams := []string{ + "realtime_start", "realtime_end", "limit", "offset", "sort_order", + "observation_start", "observation_end", "units", "frequency", + "aggregation_method", "output_type", + } + + for _, param := range optionalParams { + if v := c.Query(param); v != "" { + params[param] = v + } + } + + url := h.buildURL("/series/search", params) + + var response models.SearchResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalServerError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) GetReleases(c *gin.Context) { + params := map[string]string{} + + optionalParams := []string{ + "realtime_start", "realtime_end", "limit", "offset", "sort_order", + } + + for _, param := range optionalParams { + if v := c.Query(param); v != "" { + params[param] = v + } + } + + url := h.buildURL("/releases", params) + + var response models.ReleasesResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalServerError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) GetReleaseDates(c *gin.Context) { + params := map[string]string{} + + optionalParams := []string{ + "realtime_start", "realtime_end", "limit", "offset", "sort_order", + "release_id", "date", "start_date", "end_date", + } + + for _, param := range optionalParams { + if v := c.Query(param); v != "" { + params[param] = v + } + } + + url := h.buildURL("/releases/dates", params) + + var response models.ReleaseDatesResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalServerError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) GetReleaseSeries(c *gin.Context) { + releaseIDStr := c.Query("release_id") + if releaseIDStr == "" { + c.JSON(http.StatusBadRequest, models.ErrorResponse{ + ErrorCode: "BadRequest", + ErrorMessage: "release_id is required", + }) + return + } + + releaseID, err := strconv.Atoi(releaseIDStr) + if err != nil { + c.JSON(http.StatusBadRequest, models.ErrorResponse{ + ErrorCode: "BadRequest", + ErrorMessage: "release_id must be a number", + }) + return + } + + params := map[string]string{ + "release_id": strings.TrimSpace(strings.Replace(strconv.Itoa(releaseID), " ", "", -1)), + } + + optionalParams := []string{ + "realtime_start", "realtime_end", "limit", "offset", "sort_order", + "observation_start", "observation_end", "units", "frequency", + "aggregation_method", "output_type", + } + + for _, param := range optionalParams { + if v := c.Query(param); v != "" { + params[param] = v + } + } + + url := h.buildURL("/release/series", params) + + var response models.SearchResponse + if err := h.fetchData(url, &response); err != nil { + c.JSON(http.StatusInternalServerError, models.ErrorResponse{ + ErrorCode: "InternalServerError", + ErrorMessage: err.Error(), + }) + return + } + + c.JSON(http.StatusOK, response) +} + +func (h *FREDHandler) HealthCheck(c *gin.Context) { + c.JSON(http.StatusOK, gin.H{ + "status": "healthy", + "service": "FRED API Proxy", + }) +} diff --git a/main.go b/main.go new file mode 100644 index 0000000..88cecbb --- /dev/null +++ b/main.go @@ -0,0 +1,80 @@ +package main + +import ( + "fmt" + "log" + "os" + "os/signal" + "syscall" + + "fred-api/config" + "fred-api/handlers" + + "github.com/gin-gonic/gin" + "github.com/joho/godotenv" +) + +func main() { + if err := godotenv.Load(); err != nil { + log.Println("No .env file found, using default config") + } + + cfg := config.Load() + + fredHandler := handlers.NewFREDHandler(cfg) + + gin.SetMode(gin.ReleaseMode) + router := gin.Default() + + router.Use(func(c *gin.Context) { + c.Header("Access-Control-Allow-Origin", "*") + c.Header("Access-Control-Allow-Methods", "GET, POST, OPTIONS") + c.Header("Access-Control-Allow-Headers", "Content-Type, Authorization") + if c.Request.Method == "OPTIONS" { + c.AbortWithStatus(204) + return + } + c.Next() + }) + + router.GET("/health", fredHandler.HealthCheck) + + api := router.Group("/api/v1") + { + api.GET("/series", fredHandler.GetSeries) + api.GET("/series/observations", fredHandler.GetObservations) + api.GET("/series/search", fredHandler.SearchSeries) + api.GET("/releases", fredHandler.GetReleases) + api.GET("/releases/dates", fredHandler.GetReleaseDates) + api.GET("/release/series", fredHandler.GetReleaseSeries) + } + + go func() { + fmt.Printf("FRED API Server starting on :%s\n", cfg.ServerPort) + fmt.Printf("FRED API Base URL: %s\n", cfg.FREDBaseURL) + fmt.Println("\nAvailable endpoints:") + fmt.Println(" GET /health - Health check") + fmt.Println(" GET /api/v1/series - Get series info") + fmt.Println(" GET /api/v1/series/observations - Get observations") + fmt.Println(" GET /api/v1/series/search - Search series") + fmt.Println(" GET /api/v1/releases - Get all releases") + fmt.Println(" GET /api/v1/releases/dates - Get release dates") + fmt.Println(" GET /api/v1/release/series - Get series in release") + fmt.Println("") + fmt.Println("Examples:") + fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series?series_id=GNPCA'") + fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series/observations?series_id=GNPCA&limit=10'") + fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series/search?search_text=GDP'") + fmt.Println("") + + if err := router.Run(":" + cfg.ServerPort); err != nil { + log.Fatalf("Failed to start server: %v", err) + } + }() + + quit := make(chan os.Signal, 1) + signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM) + <-quit + + fmt.Println("\nShutting down server...") +} diff --git a/models/models.go b/models/models.go new file mode 100644 index 0000000..30636c4 --- /dev/null +++ b/models/models.go @@ -0,0 +1,105 @@ +package models + +type Series struct { + ID string `json:"id"` + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Title string `json:"title"` + ObservationStart string `json:"observation_start"` + ObservationEnd string `json:"observation_end"` + Frequency string `json:"frequency"` + FrequencyShort string `json:"frequency_short"` + Units string `json:"units"` + UnitsShort string `json:"units_short"` + SeasonalAdjustment string `json:"seasonal_adjustment"` + SeasonalAdjustmentShort string `json:"seasonal_adjustment_short"` + LastUpdated string `json:"last_updated"` + Popularity int `json:"popularity"` + Notes string `json:"notes,omitempty"` +} + +type SeriesListResponse struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Seriess []Series `json:"seriess"` +} + +type Observation struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Date string `json:"date"` + Value string `json:"value"` +} + +type ObservationsResponse struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + ObservationStart string `json:"observation_start"` + ObservationEnd string `json:"observation_end"` + Units string `json:"units"` + OutputType int `json:"output_type"` + FileType string `json:"file_type"` + OrderBy string `json:"order_by"` + SortOrder string `json:"sort_order"` + Count int `json:"count"` + Offset int `json:"offset"` + Limit int `json:"limit"` + Observations []Observation `json:"observations"` +} + +type SearchResult struct { + ID string `json:"id"` + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Title string `json:"title"` + Frequency string `json:"frequency"` + Units string `json:"units"` +} + +type SearchResponse struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Count int `json:"count"` + Offset int `json:"offset"` + Limit int `json:"limit"` + OrderBy string `json:"order_by"` + SortOrder string `json:"sort_order"` + Results []SearchResult `json:"seriess"` +} + +type Release struct { + ID int `json:"id"` + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Link string `json:"link"` + Name string `json:"name"` + PressRelease bool `json:"press_release"` + Notes string `json:"notes,omitempty"` +} + +type ReleasesResponse struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Count int `json:"count"` + Offset int `json:"offset"` + Limit int `json:"limit"` + Releases []Release `json:"releases"` +} + +type ReleaseDatesResponse struct { + RealtimeStart string `json:"realtime_start"` + RealtimeEnd string `json:"realtime_end"` + Count int `json:"count"` + Offset int `json:"offset"` + Limit int `json:"limit"` + ReleaseDates []struct { + ReleaseID int `json:"release_id"` + Date string `json:"date"` + ReleaseName string `json:"release_name"` + } `json:"release_dates"` +} + +type ErrorResponse struct { + ErrorCode string `json:"error_code"` + ErrorMessage string `json:"error_message"` +} diff --git a/server.log b/server.log new file mode 100644 index 0000000..da79f4b --- /dev/null +++ b/server.log @@ -0,0 +1,31 @@ +2026/03/31 13:04:35 No .env file found, using default config +FRED API Server starting on :8080 +FRED API Base URL: https://api.stlouisfed.org/fred + +Available endpoints: + GET /health - Health check + GET /api/v1/series - Get series info + GET /api/v1/series/observations - Get observations + GET /api/v1/series/search - Search series + GET /api/v1/releases - Get all releases + GET /api/v1/releases/dates - Get release dates + GET /api/v1/release/series - Get series in release + +Examples: + curl 'http://localhost:8080/api/v1/series?series_id=GNPCA' + curl 'http://localhost:8080/api/v1/series/observations?series_id=GNPCA&limit=10' + curl 'http://localhost:8080/api/v1/series/search?search_text=GDP' + +[GIN] 2026/03/31 - 13:04:37 | 200 | 65.258µs | ::1 | GET "/health" +[GIN] 2026/03/31 - 13:26:20 | 200 | 54.616µs | ::1 | GET "/health" +[GIN] 2026/03/31 - 13:26:24 | 200 | 50.001µs | ::1 | GET "/health" +[GIN] 2026/03/31 - 13:26:26 | 200 | 357.800542ms | ::1 | GET "/api/v1/series?series_id=GNPCA" +[GIN] 2026/03/31 - 13:26:26 | 200 | 294.788721ms | ::1 | GET "/api/v1/series/observations?series_id=GNPCA&limit=5&sort_order=desc" +[GIN] 2026/03/31 - 13:26:29 | 200 | 2.612991796s | ::1 | GET "/api/v1/series/search?search_text=unemployment&limit=3" +[GIN] 2026/03/31 - 13:26:33 | 200 | 52.442µs | ::1 | GET "/health" +[GIN] 2026/03/31 - 13:26:34 | 200 | 326.98803ms | ::1 | GET "/api/v1/series?series_id=GNPCA" +[GIN] 2026/03/31 - 13:26:35 | 200 | 288.81544ms | ::1 | GET "/api/v1/series/observations?series_id=GNPCA&limit=5&sort_order=desc" +[GIN] 2026/03/31 - 13:26:41 | 500 | 1.001380921s | ::1 | GET "/api/v1/releases?limit=3" +[GIN] 2026/03/31 - 13:26:42 | 200 | 3.419214632s | ::1 | GET "/api/v1/series/search?search_text=unemployment%20rate&limit=3" + +Shutting down server... diff --git a/tests/go.mod b/tests/go.mod new file mode 100644 index 0000000..08caa67 --- /dev/null +++ b/tests/go.mod @@ -0,0 +1,3 @@ +module fred-api-test + +go 1.21 diff --git a/tests/test_fred_api.go b/tests/test_fred_api.go new file mode 100644 index 0000000..e32cb17 --- /dev/null +++ b/tests/test_fred_api.go @@ -0,0 +1,88 @@ +package main + +import ( + "encoding/json" + "fmt" + "io" + "net/http" + "net/url" +) + +const ( + APIKey = "987b9c3428a3d0fe90179e3e6298d05e" + BaseURL = "https://api.stlouisfed.org/fred" +) + +func buildURL(endpoint string, params map[string]string) string { + u, _ := url.Parse(BaseURL + endpoint) + query := u.Query() + query.Set("api_key", APIKey) + query.Set("file_type", "json") + for k, v := range params { + if v != "" { + query.Set(k, v) + } + } + u.RawQuery = query.Encode() + return u.String() +} + +func fetchAndPrint(endpoint string, params map[string]string) { + url := buildURL(endpoint, params) + fmt.Printf("\n=== Testing %s ===\n", endpoint) + fmt.Printf("URL: %s\n\n", url) + + resp, err := http.Get(url) + if err != nil { + fmt.Printf("Error: %v\n", err) + return + } + defer resp.Body.Close() + + body, err := io.ReadAll(resp.Body) + if err != nil { + fmt.Printf("Error reading body: %v\n", err) + return + } + + var prettyJSON map[string]interface{} + if err := json.Unmarshal(body, &prettyJSON); err == nil { + output, _ := json.MarshalIndent(prettyJSON, "", " ") + fmt.Printf("Response:\n%s\n", output) + } else { + fmt.Printf("Response:\n%s\n", string(body)) + } +} + +func main() { + fmt.Println("========================================") + fmt.Println(" FRED API 测试脚本") + fmt.Println("========================================") + + fetchAndPrint("/series", map[string]string{"series_id": "GNPCA"}) + + fetchAndPrint("/series/observations", map[string]string{ + "series_id": "GNPCA", + "limit": "5", + "observation_end": "2000-01-01", + }) + + fetchAndPrint("/series/search", map[string]string{ + "search_text": "GDP", + "limit": "3", + }) + + fetchAndPrint("/releases", map[string]string{ + "limit": "3", + }) + + fetchAndPrint("/releases/dates", map[string]string{ + "limit": "3", + "start_date": "2026-03-01", + "end_date": "2026-03-31", + }) + + fmt.Println("\n========================================") + fmt.Println(" 测试完成!") + fmt.Println("========================================") +}