API для розробників
Не опитуйте, ми повідомимо самі
Зареєструйте URL і виберіть події. Ми надішлемо підписаний POST за кілька секунд після кожної зміни й повторюватимемо до 24 годин у разі збою.
Події
rate.updatedКурс валюти змінився в одному з банківrate.best_changedЗмінилася найнижча ціна продажу або найвища ціна купівліrate.threshold_crossedКурс перетнув заданий вами порігcbe.rate_changedЗмінився курс Центробанкуgold.updatedЗмінилися ціни на золотоsilver.updatedЗмінилися ціни на сріблоtransfer.quotes_updatedЗмінилися ціни сервісів переказівcertificate.createdБанк випустив новий сертифікатcertificate.rate_changedЗмінилася дохідність сертифікатаtbill.auction_resultРезультат аукціону казначейських векселівfund.price_updatedОновилася ціна паю фондуstatus.incidentЗбій сервісу почався або закінчивсяЩо ми надсилаємо
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 }
}
}Перевірка підпису
Кожен запит підписано секретом вашої адреси за HMAC SHA-256. Відхиляйте все, що старше за 5 хвилин.
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));
}Доставка та повтори
- Тайм-аут
- Відповідайте кодом 2xx протягом 10 секунд
- Повтори
- 8 спроб за 24 години зі зростаючим інтервалом
- Дублікати
- Подія може прийти двічі, тож пропускайте повтори за її id
- Порядок
- Порівнюйте created_at, бо порядок не гарантовано
- Призупинення
- Після 3 днів збоїв ми призупиняємо адресу й пишемо вам листа, а пропущене можна надіслати повторно
Ваші адреси
Вебхуки вже незабаромТут можна буде додати адреси, коли відкриються вебхуки. Вони входять у Pro і вище.
Незабаром