Developer

Мова: Українська
Вигляд

Тема

Колір акценту

Тема й колір збережуться на satelit.md і в застосунку.

Увійти

Де змінити тему?

Оберіть, де застосувати нову тему.

Змінити можна будь-коли в шапці.

Посібник · Node.js 18+

Віджет курсу валют НБМ

HTML-блок з офіційним курсом Національного банку Молдови, зміною за 30 днів і невеликою лінією для кожної валюти. Статичний: жодного запиту з браузера читача, жодного ключа на сторінці.

Працює на
Node.js 18+
Один запуск
4 кредити
На місяць
88 кредитів
Налаштування
5 хв
$ CODES=EUR,USD,RON DAYS=30 node rates_widget.mjsrates-widget.html: 3 currencies, 4 credits

Як це працює

  1. Бере курси дня з /v1/rates і залишає валюти з CODES.
  2. Для кожної валюти бере історію за DAYS днів із /v1/rates/history.
  3. Малює лінію як SVG на сторінці, без бібліотеки графіків.
  4. Пише rates-widget.html і rates.json із джерелом НБМ під цифрами, як вимагає ліцензія CC BY 4.0.

Скільки коштує: 1 кредит за курси, по 1 за кожну історію: 4 кредити для трьох валют. Запуск кожного робочого дня: 88 кредитів на місяць. Вміщується в план Start.

Як запустити

bash
export SATELIT_KEY=sat_live_...
CODES=EUR,USD,RON DAYS=30 node rates_widget.mjs

Що виводить

stdout
rates-widget.html: 3 currencies, 4 credits

Повний скрипт

rates_widget.mjs
#!/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`);

Використані маршрути

Дані в посібнику

Оновлено:

Питання про цей посібник

Чому не викликати API просто зі сторінки?

Ключ потрапив би в браузер кожного, хто відкрив сторінку. Скрипт працює на сервері раз на день і пише статичний файл: ключ лишається у вас, а сторінка вантажиться без зайвих запитів.

Коли НБМ публікує курс?

НБМ встановлює офіційний курс кожного робочого дня. Cron із посібника запускається о 13:15 з понеділка по п'ятницю; поле date у відповіді каже, на який день курс.

Чи можна використовувати дані НБМ на комерційному сайті?

Дані НБМ під ліцензією CC BY 4.0: їх можна використовувати із зазначенням джерела. Віджет ставить під цифрами рядок із meta.attribution. Ці самі дані безкоштовні на bnm.md.