Ontwikkelaars-API
Stop met pollen, wij laten het weten
Registreer een URL en kies gebeurtenissen. Binnen enkele seconden na elke wijziging sturen we een ondertekende POST, en bij een fout proberen we het tot 24 uur lang opnieuw.
Gebeurtenissen
rate.updatedEen wisselkoers is bij een bank gewijzigdrate.best_changedDe goedkoopste verkoop of hoogste aankoop is gewijzigdrate.threshold_crossedEen koers heeft een door jou ingestelde grens overschredencbe.rate_changedDe koers van de Centrale Bank is gewijzigdgold.updatedGoudprijzen zijn gewijzigdsilver.updatedZilverprijzen zijn gewijzigdtransfer.quotes_updatedPrijzen van overboekingsaanbieders zijn gewijzigdcertificate.createdEen bank heeft een nieuw certificaat gelanceerdcertificate.rate_changedHet rendement van een certificaat is gewijzigdtbill.auction_resultEen uitslag van een veiling van schatkistpapierfund.price_updatedDe koers per deelbewijs van een fonds is bijgewerktstatus.incidentEen storing is begonnen of voorbijWat we sturen
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 }
}
}Controleer de handtekening
Elk verzoek wordt ondertekend met het geheim van je endpoint via HMAC SHA-256. Weiger alles wat ouder is dan 5 minuten.
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));
}Bezorging en nieuwe pogingen
- Time-out
- Antwoord binnen 10 seconden met 2xx
- Nieuwe pogingen
- 8 pogingen in 24 uur, steeds verder uit elkaar
- Dubbele meldingen
- Een gebeurtenis kan twee keer aankomen, dus gebruik de id om herhalingen over te slaan
- Volgorde
- Vergelijk created_at, want de volgorde is niet gegarandeerd
- Pauzeren
- Na 3 dagen met fouten pauzeren we een endpoint en mailen we je, en je kunt opnieuw laten sturen wat je hebt gemist
Je endpoints
Webhooks komen eraanJe voegt hier endpoints toe zodra webhooks opengaan. Ze horen bij Pro en hoger.
Binnenkort