API Kurs Mata Uang: Panduan untuk Pengembang

API mata uang, API kurs, API FX, dan API forex adalah istilah yang saling tumpang tindih. Mulailah dari kebutuhan aplikasi, lalu periksa bentuk respons, sumber, kesegaran, riwayat, dan batas pemakaian.

Apa yang dilakukan API kurs mata uang

API menerima kode seperti USD, EUR, atau JPY, lalu mengembalikan kurs atau nilai konversi. Umumnya tersedia kurs terbaru, konversi, tanggal lampau, dan rangkaian historis.

Buat permintaan kurs pertama

Permintaan ini mengambil EUR dan GBP dengan USD sebagai dasar. Coba tanpa kunci API untuk memeriksa respons sebelum membuat kredensial.

curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

Baca rates bersama source, market_session, timestamp, dan data_updated_at. Angka dipakai untuk perhitungan; metadata menjelaskan asal dan waktunya.

API mata uang, kurs, FX, dan forex

Keempat istilah dipakai secara longgar. Forex dapat mengarah ke perdagangan, tetapi kontraklah yang menunjukkan midpoint indikatif, bid/ask, atau eksekusi.

Pahami mata uang dasar dan kuotasi

Pada USD/EUR, USD adalah dasar dan EUR adalah kuotasi. Nilai 0.84 berarti satu dolar AS setara 0,84 euro. Simpan kedua kode.

Panggil API dari sisi server

Di produksi, simpan kunci di server, tetapkan timeout, tolak respons gagal, dan cache sesuai kesegaran yang diperlukan.

const response = await fetch(
  "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP",
  {
    headers: {
      Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}`,
    },
    signal: AbortSignal.timeout(5000),
  },
);

if (!response.ok) {
  throw new Error(`exchange_rate_api_${response.status}`);
}

const snapshot = await response.json();
console.log(snapshot.rates.EUR, snapshot.data_updated_at);

Pilih berdasarkan bukti yang dibutuhkan aplikasi

• Pastikan mata uang dan pasangan yang tepat.
• Bedakan referensi harian dari observasi intrahari.
• Periksa tanggal awal, interval, dan celah historis.
• Cari sumber, waktu, kesegaran, dan derivasi yang jelas.
• Rancang kuota, cache, retry, dan perilaku gagal.
• Pisahkan kurs indikatif dari harga penyelesaian.

Hindari kesalahan integrasi umum

Jangan taruh kunci di JavaScript browser, mengganti kegagalan dengan nol, atau memberi waktu baru pada data lama. Simpan observasi sukses terakhir dan tampilkan status kedaluwarsanya.

API FX vs API Forex vs API Mata Uang