Вебхуки
Вместо опроса 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.
{
"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. Сохраняйте его, чтобы игнорировать дубликаты.
Проверка
В панели вы отправляете тестовое событие и видите последние доставки с их статусом.