Primul apel, în trei pași.
Baza este https://api.satelit.md/v1. HTTPS, JSON, UTF-8. API-ul este doar pentru citire.
-
Alege planul și ia cheia
Ceri planul din panou, cu contul Satelit. Când e activ, creezi o cheie. O vezi o singură dată. Arată așa:
sat_live_…. -
Fă apelul
Trimite cheia în antetul
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"]); -
Citește răspunsul
dataare răspunsul,metaare creditele, data și sursele. Antetele spun cât mai ai.{ "data": [ { "code": "EUR", "name": "Euro", "value": 20.0905, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.6, "change_30d_pct": -0.1 }, { "code": "USD", "name": "Dolar SUA", "value": 17.9476, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.6, "change_30d_pct": 0.8 }, { "code": "RON", "name": "Leu românesc", "value": 3.7628, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.5, "change_30d_pct": -1.2 }, { "code": "UAH", "name": "Grivnă ucraineană", "value": 0.3958, "nominal": 1, "date": "2026-11-02", "change_7d_pct": 0, "change_30d_pct": -0.2 }, { "code": "RUB", "name": "Rublă rusească", "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": "Aceleași date sunt gratuite la bnm.md." } }
Fără cheie
GET /v1/sample merge fără cheie: curs, plafon, știri și digestul zilei. Așa vezi forma datelor înainte să intri.
Convenții
- Limba:
?lang=ro|ru|en|uk, implicitro. - Date:
YYYY-MM-DD. Orele sunt ISO 8601, cu fus orar. - Bani: în lei (MDL), ca numere.
- Metode: GET, HEAD și OPTIONS. API-ul doar citește.
- CORS:
*, fără cookie-uri. Poți apela API-ul direct din browser, dar nu pune o cheie plătită într-o pagină publică.
Plicul de răspuns
Toate rutele răspund la fel. meta.attribution este rândul pe care planul tău îl arată pe pagină. meta.page apare doar pe liste.
{
"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
}
}
}Ghiduri
- AutentificareCheia, antetele și ce face API-ul cu ea.
- Credite și limiteCredite, limite pe minut, antete, 429.
- EroriFiecare cod de eroare și ce faci când apare.
- WebhooksEvenimente trimise la tine, cu semnătură.
- OAuth și OpenID„Intră cu Satelit” pe site-ul tău, cu PKCE.
- Server MCPSatelit în aplicația AI a unei persoane: protocol, OAuth, instrumente.
- Referință APIToate rutele, cu parametri și exemple.