Geliştirici API'si

Genel bakışBaşvuruWebhook'larKütüphanelerAnahtarlar ve kullanımPaketler

Sürekli sormayın, biz haber verelim

Bir URL kaydedin ve olayları seçin. Her değişiklikten birkaç saniye sonra imzalı bir POST göndeririz ve başarısız olursa 24 saate kadar yeniden deneriz.

Olaylar

rate.updatedHerhangi bir bankada bir döviz kuru değişti
rate.best_changedEn ucuz satış veya en yüksek alış değişti
rate.threshold_crossedBir kur belirlediğiniz sınırı geçti
cbe.rate_changedMerkez Bankası kuru değişti
gold.updatedAltın fiyatları değişti
silver.updatedGümüş fiyatları değişti
transfer.quotes_updatedTransfer hizmetlerinin fiyatları değişti
certificate.createdBir banka yeni bir sertifika çıkardı
certificate.rate_changedBir sertifikanın getirisi değişti
tbill.auction_resultBir hazine bonosu ihale sonucu
fund.price_updatedBir fonun pay fiyatı güncellendi
status.incidentBir hizmet kesintisi başladı veya sona erdi

Ne gönderiyoruz

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 }
  }
}

İmzayı doğrulayın

Her istek, adresinizin gizli anahtarıyla HMAC SHA-256 kullanılarak imzalanır. 5 dakikadan eski her şeyi reddedin.

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));
}

Teslimat ve yeniden denemeler

Zaman aşımı
10 saniye içinde 2xx ile yanıt verin
Yeniden denemeler
24 saat boyunca, aralıkları giderek uzayan 8 deneme
Yinelenenler
Bir olay iki kez gelebilir, bu yüzden tekrarları atlamak için id değerini kullanın
Sıra
Sıra garanti edilmediği için created_at değerini karşılaştırın
Duraklatma
3 gün boyunca başarısız olan bir adresi duraklatır ve size e-posta göndeririz, kaçırdıklarınızı yeniden gönderebilirsiniz

Adresleriniz

Webhook'lar yoldaWebhook'lar açıldığında adresleri buradan ekleyeceksiniz. Pro ve üstü paketlerde yer alırlar.
Çok yakında