API untuk pengembang

IkhtisarReferensiWebhookSDKKunci dan pemakaianPaket

Tak perlu terus mengecek, kami yang kabari

Daftarkan URL dan pilih peristiwa. Kami mengirim POST bertanda tangan dalam hitungan detik setelah setiap perubahan, dan mencoba ulang hingga 24 jam jika gagal.

Peristiwa

rate.updatedKurs mata uang berubah di salah satu bank
rate.best_changedKurs jual termurah atau kurs beli tertinggi berubah
rate.threshold_crossedKurs melewati batas yang Anda tetapkan
cbe.rate_changedKurs Bank Sentral berubah
gold.updatedHarga emas berubah
silver.updatedHarga perak berubah
transfer.quotes_updatedHarga penyedia transfer berubah
certificate.createdBank meluncurkan sertifikat baru
certificate.rate_changedImbal hasil sertifikat berubah
tbill.auction_resultHasil lelang surat utang negara
fund.price_updatedHarga unit reksa dana diperbarui
status.incidentGangguan layanan dimulai atau berakhir

Apa yang kami kirim

POST https://example.com/geneh
Geneh-Event: rate.best_changed
Geneh-Signature: t=1792118220,v1=5f2b9c1e7a

{
  "id": "evt_01JB7Q2K",
  "type": "rate.best_changed",
  "created_at": "2026-10-16T00:37:00Z",
  "data": {
    "currency": "USD",
    "side": "sell",
    "previous": { "bank": "nbe", "rate": 53.52 },
    "current": { "bank": "credit_agricole", "rate": 53.47 }
  }
}

Periksa tanda tangan

Setiap permintaan ditandatangani dengan rahasia endpoint Anda memakai HMAC SHA-256. Tolak apa pun yang lebih lama dari 5 menit.

import crypto from "node:crypto";

function verify(rawBody, header, secret) {
  const [t, v1] = header.split(",").map(p => p.split("=")[1]);
  const mac = crypto.createHmac("sha256", secret)
    .update(t + "." + rawBody).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - t) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

Pengiriman dan percobaan ulang

Batas waktu
Balas dengan 2xx dalam 10 detik
Percobaan ulang
8 kali percobaan selama 24 jam, dengan jeda yang makin panjang
Duplikat
Sebuah peristiwa bisa tiba dua kali, jadi gunakan id-nya untuk melewati pengulangan
Urutan
Bandingkan created_at, karena urutan tidak dijamin
Penjedaan
Kami menjeda endpoint setelah 3 hari gagal dan mengirimi Anda email, lalu Anda bisa memutar ulang yang terlewat

Endpoint Anda

Webhook segera hadirAnda bisa menambahkan endpoint di sini setelah webhook dibuka. Tersedia mulai paket Pro.
Segera hadir