Перший виклик у три кроки.
Базова адреса: https://api.satelit.md/v1. HTTPS, JSON, UTF-8. API призначений лише для читання.
-
Оберіть тариф і отримайте ключ
Запитайте тариф у панелі через обліковий запис Satelit. Коли його увімкнено, створіть ключ. Його видно лише один раз. Він виглядає так:
sat_live_…. -
Зробіть виклик
Надішліть ключ у заголовку
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"]); -
Прочитайте відповідь
dataмістить відповідь,metaмістить кредити, дату та джерела. Заголовки показують, скільки кредитів у вас лишилося.{ "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 є лише у списків.
{
"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
}
}
}Посібники
- АвтентифікаціяКлюч, заголовки та те, що API робить з ключем.
- Кредити та лімітиКредити, ліміти на хвилину, заголовки, 429.
- ПомилкиКожен код помилки та що робити, коли він трапляється.
- WebhooksПодії, що надсилаються вам, із підписом.
- OAuth і OpenID«Увійти через Satelit» на вашому сайті, з PKCE.
- MCP-серверSatelit у ШІ-застосунку людини: протокол, OAuth, інструменти.
- Довідник APIУсі маршрути з параметрами та прикладами.