Cara Menggunakan API Kurs Mata Uang di GGapi
Panduan cepat memanggil API kurs mata uang GGapi: dapatkan API key, hit endpoint exchange rate, filter symbols, dan baca response JSON dengan timestamp WIB.
Apa itu API kurs mata uang GGapi?
API kurs mata uang GGapi menyediakan nilai tukar real-time untuk pasangan mata uang utama. Data di-refresh sekitar setiap 5 menit dan dilengkapi timestamp WIB agar cocok untuk operasi fintech, e-commerce, dan dashboard keuangan di Indonesia.
Untuk kurs pajak resmi (KMK Kemenkeu), gunakan produk terpisah Indonesia Bank Exchange Rate. Untuk kurs pasar global, gunakan Global Exchange Rate.
Langkah 1 — Daftar dan ambil API key
Login di ggapi.co.id, buka Credentials, lalu buat API key. Kirim key pada header x-ggapi-co-id di setiap request. Satu key berlaku untuk seluruh katalog API.
Langkah 2 — Panggil endpoint kurs terbaru
Endpoint Global Exchange Rate: GET https://use.ggapi.co.id/api/exchange-rate/latest. Parameter opsional base (default USD) dan symbols (CSV, misalnya IDR,EUR).
- base=IDR untuk menampilkan rate relatif ke rupiah
- symbols=USD,EUR,JPY untuk membatasi output
- Cek field updated_at (WIB) sebelum menyimpan ke cache aplikasi
Langkah 3 — Integrasi di aplikasi
Simpan response rates ke cache singkat (1–5 menit) agar hemat kuota. Untuk perhitungan bea/pajak resmi, jangan mengandalkan kurs pasar — pakai API Kurs Pajak Kemenkeu.
Mulai dari halaman layanan API Kurs Mata Uang atau langsung ke halaman produk Global Exchange Rate di katalog GGapi.