Autentificare

O cheie arată așa: sat_live_ urmat de 32 de caractere. O trimiți la fiecare apel. Cookie-urile nu sunt citite pe acest domeniu.

Cum trimiți cheia

Două forme, la alegere. Prima e cea recomandată.

curl https://api.satelit.md/v1/me \
  -H "Authorization: Bearer $SATELIT_KEY"

# or
curl https://api.satelit.md/v1/me \
  -H "X-Api-Key: $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/me", {
  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/me",
    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/me");
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"]);

Cum păstrezi cheia

O vezi o singură dată, la creare. Noi păstrăm doar amprenta ei (sha256) și primele 12 caractere, ca s-o recunoști în panou.
Ține-o într-o variabilă de mediu pe server. Nu o pune în codul unei pagini publice și nu o trimite în git.
Dacă s-a scurs: creează una nouă și revocă-o pe cea veche din panou. Revocarea e imediată.

Câte chei ai pe plan

Start	1
Creator	3
Pro	10
Business	50
Enterprise	prin contract

Rute fără cheie

/v1/sample, /v1/products, /v1/plans și /v1/status merg fără cheie. /v1/sample are o limită de 60 de apeluri pe minut, pe IP.

Când cheia nu e bună

Fără cheie: 401 auth_required. Cheie necunoscută sau revocată: 401 key_invalid. După 30 de încercări greșite într-un minut de pe același IP, răspunsul devine 429.

Verifică cheia

GET /v1/me nu costă credite și arată planul, creditele rămase și limita pe minut.

GET /v1/me

{
  "data": {
    "plan": "creator",
    "credits": {
      "limit": 30000,
      "used": 4210,
      "reset": "2026-12-01T00:00:00+02:00",
      "plan": 30000,
      "extra": 0
    },
    "rate": {
      "per_minute": 120
    },
    "key": {
      "name": "blog",
      "prefix": "sat_live_a1b"
    }
  },
  "meta": {
    "credits": 0
  }
}