Tutorial/Go 快速入門

用 Go net/http 攞匯率

用 net/http、timeout、環境變數認證同更新欄位,整一個有類型嘅 Go client。

ERexchangerate.dev·Sep 8, 2026·閱讀約 6 分鐘

Go 標準庫已經夠做可靠整合。解 JSON 之前先檢查 HTTP 狀態,同時保存來源、市場時段同更新時間。

Key points
整有類型嘅 client: 用 net/http、context 同 encoding/json 一次攞幾隻貨幣。只有設定咗 EXCHANGERATE_API_KEY 先加 Bearer。
用 timeout 呼叫: context.WithTimeout 可以避免卡住嘅連線長時間佔住 worker。正式環境應該重用 http.Client。
處理錯誤同新鮮度: 401 要修正 key,429 要減少請求。保留 source、market_session、data_updated_at,亦唔好將 key 放入瀏覽器或者手機 app。

整有類型嘅 client

用 net/http、context 同 encoding/json 一次攞幾隻貨幣。只有設定咗 EXCHANGERATE_API_KEY 先加 Bearer。

go · main.gocopy
package main

import (
  "context"
  "encoding/json"
  "fmt"
  "net/http"
  "log"
  "os"
  "regexp"
  "strings"
  "time"
)

type Latest struct {
  Base          string             `json:"base"`
  Source        string             `json:"source"`
  MarketSession string             `json:"market_session"`
  UpdatedAt     time.Time          `json:"data_updated_at"`
  Sources       map[string]string  `json:"sources"`
  EffectiveAt   map[string]string  `json:"effective_at"`
  Rates         map[string]json.Number `json:"rates"`
}

func LatestRates(ctx context.Context, base string) (Latest, error) {
  base = strings.ToUpper(base)
  if !regexp.MustCompile("^[A-Z]{3}$").MatchString(base) {
    return Latest{}, fmt.Errorf("invalid base currency: %q", base)
  }
  url := "https://api.exchangerate.dev/v1/latest/" + base + "?symbols=EUR,GBP,JPY"
  req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
  if err != nil { return Latest{}, err }
  if key := os.Getenv("EXCHANGERATE_API_KEY"); key != "" {
    req.Header.Set("Authorization", "Bearer "+key)
  }

  client := &http.Client{Timeout: 5 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error {
    return http.ErrUseLastResponse
  }}
  res, err := client.Do(req)
  if err != nil { return Latest{}, err }
  defer res.Body.Close()
  if res.StatusCode < 200 || res.StatusCode >= 300 {
    return Latest{}, fmt.Errorf("exchange rate API: HTTP %s", res.Status)
  }
  var out Latest
  if err := json.NewDecoder(res.Body).Decode(&out); err != nil { return Latest{}, err }
  return out, nil
}

func main() {
  ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
  defer cancel()
  latest, err := LatestRates(ctx, "USD")
  if err != nil { log.Fatal(err) }
  fmt.Println(latest.Rates["EUR"], latest.Sources["EUR"], latest.EffectiveAt["EUR"])
}

用 timeout 呼叫

shell · run main.gocopy
go run main.go

處理錯誤同新鮮度

401 要修正 key,429 要減少請求。保留 source、market_session、data_updated_at,亦唔好將 key 放入瀏覽器或者手機 app。

一齊保存匯率上下文
日報可以每日呼叫一次,營運 dashboard 可以每個鐘呼叫一次。收到 429 就降低頻率,唔好即時製造重試風暴。
  • 將匯率連同來源同時間保存。
  • 用作自動化、估算、報表同分析。
  • 唔好當成可以成交嘅報價。
ER
exchangerate.dev
為開發者提供嘅整合指南。

延伸閱讀

Reference匯率 API 快速入門閱讀 TutorialPython閱讀 Referencesource / market_session閱讀
更多比較Fixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
學習Reading source and market_session in your pipelineIndicative vs executable FX rates: what a rates API actually gives youECB reference rates, explained
即時匯率EUR/USDGBP/USDUSD/JPY