Fejlesztői API

ÁttekintésReferenciaWebhookokSDK-kKulcsok és használatCsomagok

Ne kérdezgess, mi szólunk

Regisztrálj egy URL-t, és válaszd ki az eseményeket. Minden változás után másodperceken belül aláírt POST kérést küldünk, és hiba esetén akár 24 órán át újrapróbáljuk.

Események

rate.updatedEgy devizaárfolyam megváltozott valamelyik banknál
rate.best_changedMegváltozott a legolcsóbb eladási vagy a legmagasabb vételi ár
rate.threshold_crossedEgy árfolyam átlépte az általad megadott határt
cbe.rate_changedMegváltozott a Központi Bank árfolyama
gold.updatedMegváltoztak az aranyárak
silver.updatedMegváltoztak az ezüstárak
transfer.quotes_updatedMegváltoztak az utalási szolgáltatók árai
certificate.createdEgy bank új betéti jegyet vezetett be
certificate.rate_changedMegváltozott egy betéti jegy hozama
tbill.auction_resultEgy kincstárjegy-aukció eredménye
fund.price_updatedFrissült egy alap jegyára
status.incidentSzolgáltatási zavar kezdődött vagy ért véget

Amit küldünk

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

Az aláírás ellenőrzése

Minden kérést a végpontod titkos kulcsával írunk alá HMAC SHA-256 használatával. Utasíts el mindent, ami 5 percnél régebbi.

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

Kézbesítés és újrapróbálás

Időkorlát
Válaszolj 2xx kóddal 10 másodpercen belül
Újrapróbálás
8 próbálkozás 24 óra alatt, egyre nagyobb időközökkel
Ismétlődések
Egy esemény kétszer is megérkezhet, ezért az id alapján szűrd ki az ismétléseket
Sorrend
Hasonlítsd össze a created_at értéket, mert a sorrend nem garantált
Szüneteltetés
3 nap hiba után szüneteltetjük a végpontot és e-mailt küldünk, a kimaradt eseményeket pedig újra lejátszhatod

A végpontjaid

A webhookok hamarosan érkeznekAmint elindulnak a webhookok, itt adhatsz hozzá végpontokat. A Pro csomagtól felfelé érhetők el.
Hamarosan