Valutaconverter API: bedragen converteren met live wisselkoersen

Stappenplan

1. Kies input: from, to, amount (en eventueel precision/rounding)
2. Vraag koers op: gebruik een timestamp om te loggen welke koers je gebruikte
3. Bereken: amount × rate met decimal‑veilige representatie
4. Rond af: in UI vaak 2 decimalen, in back‑office soms 4–6
5. Cache slim: bijv. per valuta‑paar en tijdvenster
6. Monitor: latency, errors, rate limits, fallback‑gedrag

Waarom rounding zo belangrijk is

Reken je in de UI af op 2 decimalen, maar maak je later refunds op basis van een andere rounding‑regel, dan ontstaan verschillen. Zorg daarom dat je response (of je eigen logging) altijd minimaal bevat:

• de gebruikte rate (koers)
• een timestamp (wanneer is de koers geldig?)
• de rounding/precision die je toepaste

Dat maakt support, finance en compliance later veel eenvoudiger.

cURL

curl -X GET "https://api.example.com/convert?from=EUR&to=USD&amount=199.99" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Pro‑tip: log response headers (rate limit / request id) voor snelle troubleshooting.

JavaScript (fetch)

async function convertCurrency({ from, to, amount }) {
  const url = new URL("https://api.example.com/convert");
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);
  url.searchParams.set("amount", String(amount));

  const res = await fetch(url.toString(), {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Accept": "application/json"
    }
  });

  if (!res.ok) {
    const body = await res.text();
    throw new Error(`Convert failed (${res.status}): ${body}`);
  }

  return res.json();
}