RU

Тема

Цвет акцента

Тема и цвет сохранятся на satelit.md и в приложении.

Панель Выбрать тариф

Вебхуки

Вместо опроса API каждую минуту вы получаете POST, когда есть что-то новое. Адресов на тарифе: 2 на Creator, 10 на Pro, 50 на Business.

События

  • news.publishedНовая новость с серьёзностью не ниже min_gravity этого адреса, по умолчанию 50.
  • law.digestЗаконодательный дайджест дня готов.
  • fuel.capANRE опубликовало новую предельную цену.
  • rates.updatedBNM опубликовал курс дня.
  • price.changedЦена отслеживаемого товара изменилась в магазине. Один адрес может перечислять до 500 товаров в items. Сравнение выполняется каждые 30 минут.

Что вы получаете

POST с JSON и двумя заголовками: Satelit-Event и Satelit-Signature.

POST
{
  "id": "evt_01J9ZK3Q",
  "type": "price.changed",
  "created_at": "2026-11-02T13:30:00+02:00",
  "data": {
    "item": 18342,
    "store": "kaufland",
    "old": 17.19,
    "new": 16.05,
    "at": "2026-11-02T13:12:00+02:00"
  }
}

Проверьте подпись

Заголовок выглядит так: t=<unix>,v1=<semnătura>. Подпись: HMAC-SHA256 с секретом адреса, от строки t.body, то есть момент времени, точка и точное, неизменённое тело запроса. Отклоняйте запросы с моментом старше 5 минут, чтобы остановить повторную отправку.

Секрет виден один раз, когда вы создаёте адрес в панели. Храните его на своём сервере.

import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody: the request body exactly as it arrived, before any JSON parsing
export function verify(rawBody, header, secret, tolerance = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > tolerance) return false;
  const expected = Buffer.from(createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex"));
  const given = Buffer.from(parts.v1 ?? "");
  return expected.length === given.length && timingSafeEqual(expected, given);
}
import hashlib
import hmac
import time


# raw_body: the request body exactly as it arrived, as bytes
def verify(raw_body, header, secret, tolerance=300):
    parts = dict(p.split("=", 1) for p in header.split(","))
    t = int(parts.get("t", 0))
    if abs(time.time() - t) > tolerance:
        return False
    signed = f"{t}.".encode() + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))
<?php
// $rawBody: the request body exactly as it arrived: file_get_contents("php://input")
function verify(string $rawBody, string $header, string $secret, int $tolerance = 300): bool {
    $parts = [];
    foreach (explode(",", $header) as $part) {
        [$k, $v] = array_pad(explode("=", $part, 2), 2, "");
        $parts[$k] = $v;
    }
    $t = (int) ($parts["t"] ?? 0);
    if (abs(time() - $t) > $tolerance) {
        return false;
    }
    $expected = hash_hmac("sha256", $t . "." . $rawBody, $secret);
    return hash_equals($expected, $parts["v1"] ?? "");
}

Как доставляется

  • Только HTTPS, на публичные адреса. Перенаправления не выполняются.
  • Мы ждём 5 секунд. Ответ 2xx означает, что запрос получен.
  • Три попытки за 15 минут.
  • После 20 неудач подряд адрес отключается. Включить его снова можно в панели.
  • У каждого события есть id. Сохраняйте его, чтобы игнорировать дубликаты.

Проверка

В панели вы отправляете тестовое событие и видите последние доставки с их статусом.

Вебхуки