Ghid · Node.js 18+
Widget curs valutar BNM
Un bloc HTML cu cursul oficial al Băncii Naționale a Moldovei, schimbarea pe 30 de zile și o linie mică pentru fiecare valută. Static: nicio cerere din browserul cititorului, nicio cheie în pagină.
- Rulează pe
- Node.js 18+
- O rulare
- 4 credite
- Pe lună
- 88 de credite
- Pornit în
- 5 min
$ CODES=EUR,USD,RON DAYS=30 node rates_widget.mjsrates-widget.html: 3 currencies, 4 creditsCum funcționează
- Ia cursurile zilei din
/v1/ratesși păstrează valutele dinCODES. - Pentru fiecare valută ia istoricul pe
DAYSzile din/v1/rates/history. - Desenează linia ca SVG în pagină, fără bibliotecă de grafice.
- Scrie
rates-widget.htmlșirates.json, cu sursa BNM sub cifre, cum cere licența CC BY 4.0.
Cât costă: 1 credit pentru cursuri, 1 pentru fiecare istoric: 4 credite cu trei valute. O rulare în fiecare zi lucrătoare: 88 de credite pe lună. Încape în planul Start.
Cum îl rulezi
export SATELIT_KEY=sat_live_...
CODES=EUR,USD,RON DAYS=30 node rates_widget.mjsCe scoate
rates-widget.html: 3 currencies, 4 creditsScriptul complet
#!/usr/bin/env node
// Exchange rate widget: BNM's official rates with a 30-day line, as one HTML block for any site.
// SATELIT_KEY=sat_live_... node rates_widget.mjs
// Optional: CODES (EUR,USD,RON), DAYS (30), OUT (rates-widget.html), WIDGET_LANG (ro).
// Writes the block and rates.json. No dependencies, Node 18 or newer, no script runs in the reader's browser.
// Put it in cron after BNM publishes: 15 13 * * 1-5 node /path/rates_widget.mjs
import { writeFileSync } from "node:fs";
const BASE = process.env.SATELIT_BASE ?? "https://api.satelit.md/v1";
const KEY = process.env.SATELIT_KEY;
const LANG = process.env.WIDGET_LANG ?? "ro";
const CODES = (process.env.CODES ?? "EUR,USD,RON").split(",").map((c) => c.trim().toUpperCase());
const DAYS = Number(process.env.DAYS ?? 30);
const OUT = process.env.OUT ?? "rates-widget.html";
if (!KEY) throw new Error("Set SATELIT_KEY");
const WORDS = {
ro: { title: "Cursul oficial BNM", days: "zile" },
ru: { title: "Официальный курс НБМ", days: "дней" },
en: { title: "Official BNM rates", days: "days" },
uk: { title: "Офіційний курс НБМ", days: "днів" },
};
const w = WORDS[LANG];
let credits = 0;
async function api(path, params = {}) {
const url = new URL(BASE + path);
for (const [k, v] of Object.entries({ lang: LANG, ...params })) url.searchParams.set(k, v);
for (let attempt = 0; ; attempt++) {
const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
const retry = Number(res.headers.get("retry-after"));
if ((res.status === 429 || res.status === 503) && retry && attempt < 2) {
await new Promise((ok) => setTimeout(ok, retry * 1000));
continue;
}
const body = await res.json();
if (!res.ok) throw new Error(`${path}: ${body.error.code}: ${body.error.message}`);
credits += body.meta.credits ?? 0;
return body;
}
}
const today = await api("/rates");
const rows = today.data.filter((r) => CODES.includes(r.code));
const history = await Promise.all(rows.map((r) => api("/rates/history", { code: r.code, days: DAYS })));
// a line of the last DAYS days, drawn as an inline SVG: no chart library, no request from the reader's page
function spark(points, width = 96, height = 28) {
const v = points.map((p) => p.value);
const min = Math.min(...v), max = Math.max(...v), span = max - min || 1;
const xy = v.map((y, i) => `${((i / Math.max(v.length - 1, 1)) * width).toFixed(1)},${(height - 2 - ((y - min) / span) * (height - 4)).toFixed(1)}`);
return `<svg viewBox="0 0 ${width} ${height}" width="${width}" height="${height}" aria-hidden="true"><polyline fill="none" stroke="currentColor" stroke-width="1.5" points="${xy.join(" ")}"/></svg>`;
}
const sign = (n) => (n > 0 ? `+${n}` : `${n}`);
const items = rows.map((r, i) => ` <li><b>${r.code}</b> <span class="v">${r.value.toFixed(4)}</span> <span class="c ${r.change_30d_pct >= 0 ? "up" : "down"}">${sign(r.change_30d_pct)}% / ${DAYS} ${w.days}</span> ${spark(history[i].data.points)}</li>`);
// BNM's licence (CC BY 4.0) asks for the source next to the numbers: the attribution line comes from the answer
const html = `<section class="satelit-rates" lang="${LANG}">
<h3>${w.title}, ${rows[0]?.date ?? ""}</h3>
<ul>
${items.join("\n")}
</ul>
<p class="src">${today.meta.attribution}</p>
</section>
<style>
.satelit-rates{font:14px/1.4 system-ui,sans-serif}.satelit-rates ul{list-style:none;margin:0;padding:0}
.satelit-rates li{display:flex;gap:.6em;align-items:center;padding:.3em 0}.satelit-rates .v{font-variant-numeric:tabular-nums}
.satelit-rates .up{color:#b42318}.satelit-rates .down{color:#067647}.satelit-rates .src{font-size:12px;opacity:.7}
</style>
`;
writeFileSync(OUT, html);
writeFileSync("rates.json", JSON.stringify({ date: rows[0]?.date, rates: rows, attribution: today.meta.attribution }, null, 2));
console.log(`${OUT}: ${rows.length} currencies, ${credits} credits`);
Rutele folosite
Întrebări despre acest ghid
De ce să nu chem API-ul direct din pagină?
Cheia ar ajunge în browserul oricui deschide pagina. Scriptul rulează pe server o dată pe zi și scrie un fișier static: cheia rămâne la tine, iar pagina se încarcă fără cereri în plus.
Când publică BNM cursul?
BNM stabilește cursul oficial în fiecare zi lucrătoare. Cronul din ghid rulează la 13:15, de luni până vineri; câmpul date din răspuns spune pentru ce zi e cursul.
Pot folosi datele BNM pe un site comercial?
Datele BNM sunt sub licența CC BY 4.0: le poți folosi cu sursa menționată. Widgetul pune sub cifre rândul din meta.attribution. Aceleași date sunt gratuite la bnm.md.