RU

Тема

Цвет акцента

Тема и цвет сохранятся на 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
    }
  }
}

Руководства