RO

Tema

Culoarea de accent

Tema și culoarea te urmează pe satelit.md și în aplicație.

Panou Alege un plan

Primul apel, în trei pași.

Baza este https://api.satelit.md/v1. HTTPS, JSON, UTF-8. API-ul este doar pentru citire.

  1. 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_….

    Alege un planChei API

  2. 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"]);
  3. Citește răspunsul

    data are răspunsul, meta are creditele, data și sursele. Antetele spun cât mai ai.

    api.satelit.md/v1/rates
    {
      "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.

Încearcă în consolă

Convenții

  • Limba: ?lang=ro|ru|en|uk, implicit ro.
  • 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.

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
    }
  }
}

Ghiduri