Автентифікація

Ключ виглядає так: sat_live_ і ще 32 символи. Ви надсилаєте його з кожним викликом. Cookie на цьому домені не читаються.

Як надсилати ключ

Дві форми, на вибір. Перша рекомендована.

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"]);

Як зберігати ключ

Ви бачите його лише раз, під час створення. Ми зберігаємо лише відбиток (sha256) і перші 12 символів, щоб ви впізнавали ключ у панелі.
Тримайте його в змінній середовища на сервері. Не вставляйте його в код публічної сторінки й не надсилайте в git.
Якщо він витік: створіть новий і відкличте старий у панелі. Відкликання діє негайно.

Скільки ключів на плані

Start	1
Creator	3
Pro	10
Business	50
Enterprise	за договором

Маршрути без ключа

/v1/sample, /v1/products, /v1/plans і /v1/status працюють без ключа. /v1/sample має ліміт 60 викликів на хвилину з одного IP.

Коли ключ не підходить

Без ключа: 401 auth_required. Невідомий або відкликаний ключ: 401 key_invalid. Після 30 хибних спроб за хвилину з одного IP відповідь стає 429.

Перевірте ключ

GET /v1/me не коштує кредитів і показує план, залишок кредитів та ліміт на хвилину.

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