डेवलपर 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));
}

डिलीवरी और दोबारा कोशिश

समय सीमा
10 सेकंड के भीतर 2xx से जवाब दें
दोबारा कोशिश
24 घंटों में 8 कोशिशें, हर बार ज़्यादा अंतराल के साथ
डुप्लिकेट
कोई इवेंट दो बार आ सकता है, इसलिए दोहराव छोड़ने के लिए उसकी id का इस्तेमाल करें
क्रम
created_at की तुलना करें, क्योंकि क्रम की गारंटी नहीं है
रोकना
3 दिन की विफलताओं के बाद हम एंडपॉइंट रोक देते हैं और आपको ईमेल करते हैं, और आप छूटे हुए इवेंट दोबारा चला सकते हैं

आपके एंडपॉइंट

वेबहुक आने वाले हैंवेबहुक शुरू होते ही आप यहाँ एंडपॉइंट जोड़ सकेंगे। ये Pro और उससे ऊपर के प्लान में मिलते हैं।
जल्द आ रहा है