UK

Тема

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

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

Панель Обрати тариф

Перший виклик у три кроки.

Базова адреса: https://api.satelit.md/v1. HTTPS, JSON, UTF-8. API призначений лише для читання.

  1. Оберіть тариф і отримайте ключ

    Запитайте тариф у панелі через обліковий запис Satelit. Коли його увімкнено, створіть ключ. Його видно лише один раз. Він виглядає так: sat_live_….

    Обрати тарифКлючі API

  2. Зробіть виклик

    Надішліть ключ у заголовку Authorization.

    curl "https://api.satelit.md/v1/rates" \
      -H "Authorization: Bearer $SATELIT_KEY"
    const res = await fetch("https://api.satelit.md/v1/rates", {
      headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
    });
    const { data, meta } = await res.json();
    console.log(data, meta.credits);
    import json, os, urllib.request
    
    req = urllib.request.Request(
        "https://api.satelit.md/v1/rates",
        headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
    )
    with urllib.request.urlopen(req) as res:
        body = json.load(res)
    print(body["data"], body["meta"]["credits"])
    <?php
    $ch = curl_init("https://api.satelit.md/v1/rates");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
    ]);
    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);
    print_r($body["data"]);
  3. Прочитайте відповідь

    data містить відповідь, meta містить кредити, дату та джерела. Заголовки показують, скільки кредитів у вас лишилося.

    api.satelit.md/v1/rates
    {
      "data": [
        {
          "code": "EUR",
          "name": "Євро",
          "value": 20.0905,
          "nominal": 1,
          "date": "2026-11-02",
          "change_7d_pct": -0.6,
          "change_30d_pct": -0.1
        },
        {
          "code": "USD",
          "name": "Долар США",
          "value": 17.9476,
          "nominal": 1,
          "date": "2026-11-02",
          "change_7d_pct": -0.6,
          "change_30d_pct": 0.8
        },
        {
          "code": "RON",
          "name": "Румунський лей",
          "value": 3.7628,
          "nominal": 1,
          "date": "2026-11-02",
          "change_7d_pct": -0.5,
          "change_30d_pct": -1.2
        },
        {
          "code": "UAH",
          "name": "Українська гривня",
          "value": 0.3958,
          "nominal": 1,
          "date": "2026-11-02",
          "change_7d_pct": 0,
          "change_30d_pct": -0.2
        },
        {
          "code": "RUB",
          "name": "Російський рубль",
          "value": 0.2228,
          "nominal": 1,
          "date": "2026-11-02",
          "change_7d_pct": -0.5,
          "change_30d_pct": 4.5
        }
      ],
      "meta": {
        "credits": 1,
        "updated_at": "2026-11-02T13:05:00+02:00",
        "sources": [
          {
            "name": "BNM",
            "url": "https://www.bnm.md/ro/official_exchange_rates",
            "license": "CC BY 4.0"
          }
        ],
        "attribution": "Sursa: Banca Națională a Moldovei, bnm.md, CC BY 4.0",
        "notice": "Ці самі дані безкоштовні на bnm.md."
      }
    }

Без ключа

GET /v1/sample працює без ключа: курс, гранична ціна, новини та дайджест дня. Так ви бачите форму даних, перш ніж увійти.

Спробувати в консолі

Конвенції

  • Мова: ?lang=ro|ru|en|uk, за замовчуванням ro.
  • Дати: YYYY-MM-DD. Час у форматі ISO 8601, з часовим поясом.
  • Гроші: у леях (MDL), числами.
  • Методи: GET, HEAD і OPTIONS. API лише читає.
  • CORS: *, без cookie. Ви можете викликати API прямо з браузера, але не вставляйте платний ключ у публічну сторінку.

Обгортка відповіді

Усі маршрути відповідають однаково. У meta.attribution лежить рядок, який ваш план вимагає показати на сторінці. meta.page є лише у списків.

meta
{
  "data": "…",
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "ANRE",
        "url": "https://anre.md/",
        "license": "Public data of ANRE"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 20,
      "total": 240,
      "pages": 12
    }
  }
}

Посібники