Аутентификация

Ключ выглядит так: 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
  }
}