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 gewijzigd
rate.best_changedDe goedkoopste verkoop of hoogste aankoop is gewijzigd
rate.threshold_crossedEen koers heeft een door jou ingestelde grens overschreden
cbe.rate_changedDe koers van de Centrale Bank is gewijzigd
gold.updatedGoudprijzen zijn gewijzigd
silver.updatedZilverprijzen zijn gewijzigd
transfer.quotes_updatedPrijzen van overboekingsaanbieders zijn gewijzigd
certificate.createdEen bank heeft een nieuw certificaat gelanceerd
certificate.rate_changedHet rendement van een certificaat is gewijzigd
tbill.auction_resultEen uitslag van een veiling van schatkistpapier
fund.price_updatedDe koers per deelbewijs van een fonds is bijgewerkt
status.incidentEen storing is begonnen of voorbij

Wat 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

De getoonde koersen zijn alleen ter informatie, en de koers die je bij het filiaal of bij het afrekenen krijgt kan afwijken. Controleer hem bij de bank of aanbieder voordat je koopt, verkoopt of geld stuurt. Geneh verkoopt geen valuta of goud en geeft geen beleggingsadvies.

Ontdek het op Google PlayDownload in de App Store