教程/用 React 构建货币转换器

用 React 构建货币转换器

用 React 构建货币转换器. 包含代码、缓存和数据新鲜度的实用指南。

ERexchangerate.dev·Sep 20, 2026·阅读约 7 分钟

在服务器端实现,不泄露凭据,并保留数据来源与观测时间。

要点
仅在服务器保存 API 密钥。
验证货币代码和金额。
缓存成功响应。
显示来源和观测时间。

步骤 1

请在服务器端执行,验证输入,并保留响应元数据。

代码示例copy
import { NextRequest, NextResponse } from "next/server";

export async function GET(request: NextRequest) {
  const { searchParams } = request.nextUrl;
  const from = searchParams.get("from")?.toUpperCase();
  const to = searchParams.get("to")?.toUpperCase();
  const amount = Number(searchParams.get("amount"));
  if (!from || !to || !Number.isFinite(amount) || amount < 0) {
    return NextResponse.json({ error: "invalid_input" }, { status: 400 });
  }

  const response = await fetch(
    `https://api.exchangerate.dev/v1/convert/${from}/${to}/${amount}`,
    {
      headers: { Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}` },
      signal: AbortSignal.timeout(5000),
      next: { revalidate: 60 },
    },
  );
  return NextResponse.json(await response.json(), { status: response.status });
}

步骤 2

代码示例copy
"use client";

import { FormEvent, useState } from "react";

type ConversionResult = {
  converted: string;
  source: string;
  data_updated_at: string;
};

export function CurrencyConverter() {
  const [amount, setAmount] = useState("100");
  const [result, setResult] = useState<ConversionResult | null>(null);
  const [error, setError] = useState("");
  const [loading, setLoading] = useState(false);

  async function submit(event: FormEvent) {
    event.preventDefault();
    setLoading(true); setError("");
    try {
      const params = new URLSearchParams({ from: "USD", to: "EUR", amount });
      const response = await fetch(`/api/convert?${params}`);
      const body = await response.json();
      if (!response.ok) throw new Error(body.error ?? "conversion_failed");
      setResult(body);
    } catch (caught) {
      setError(caught instanceof Error ? caught.message : "conversion_failed");
    } finally { setLoading(false); }
  }

  return <form onSubmit={submit}>
    <input value={amount} onChange={(event) => setAmount(event.target.value)} inputMode="decimal" />
    <button disabled={loading}>{loading ? "Converting…" : "Convert"}</button>
    {error && <p role="alert">{error}</p>}
    {result && <output>{result.converted} EUR · {result.source} · {result.data_updated_at}</output>}
  </form>;
}

步骤 3

  • 仅在服务器保存 API 密钥。
  • 验证货币代码和金额。
  • 缓存成功响应。
  • 显示来源和观测时间。
指南
这些汇率仅供参考,并非结算价格。
ER
exchangerate.dev
面向货币数据开发者的实用指南。

继续阅读

指南面向开发者的货币转换 API阅读 指南API errors and response fields阅读