Stiahnite si svoje články.
Zverejnite ich po svojom.

Každá požiadavka

Authorization: Bearer sns_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json

Skontrolujte, že to funguje

curl https://seonis.ai/api/v1/me \
  -H "Authorization: Bearer $SEONIS_API_KEY"

{
  "organisation": { "id": 12, "name": "Peppervale", "country": "GB" },
  "key": {
    "name": "Production build",
    "prefix": "sns_live_ab",
    "created_at": "2026-09-06T09:12:44+00:00",
    "last_used_at": "2026-09-06T09:31:02+00:00"
  },
  "sites": 2
}

Limit požiadaviek

120 požiadaviek za minútu, počítaných podľa kľúča, nie podľa adresy, z ktorej prichádzajú, pretože build runnery zdieľajú adresy. Nad tento limit dostanete 429 so štandardnými hlavičkami Retry-After a X-RateLimit. Na stiahnutie článkov pre build stačí niekoľko požiadaviek, takže na tento limit by ste nemali naraziť omylom.

Nedávajte kľúč do svojho repozitára

Číta všetko, čo sme napísali pre Váš účet, vrátane článkov, ktoré ešte nie sú zverejnené. Dajte ho do svojho build prostredia, nie do zdrojového kódu. Zrušte ho tu hneď, ako sa objaví niekde, kde nemá byť, a všetko, čo ho používa, okamžite dostane 401.

API môžete používať aj bez jeho pripojenia: endpointy fungujú pre každý účet s kľúčom. Pripojenie je spôsob, ako zvyšok produktu zistí, že už nemá očakávať vlastnú adresu, a zároveň zabráni tomu, aby sa článok, ktorý publikujete sami, počítal ako zlyhanie.

webhook-id: 7c1e2f0a-3b5d-4e8f-9a61-2d4c8b0e5f13
webhook-timestamp: 1790490600
webhook-signature: v1,s0RzLJ1d7Cxd9nwe8pqER9DWy/stEIB+uT9MlGVLlM0=

Hlavička	Čo to je
webhook-id	Doručenie, rovnaká hodnota ako delivery_id v tele. Zapamätajte si tie, ktoré ste už spracovali, a na opakovanie odpovedzte 200 bez toho, aby ste prácu robili znova.
webhook-timestamp	Čas, keď sme ho podpísali, v celých sekundách od roku 1970. Odmietnite všetko, čo sa od Vašich hodín líši o viac ako päť minút, aby Vám staré doručenie nebolo možné poslať znova.
webhook-signature	v1, potom base64 HMAC-SHA256 z id, časovej pečiatky a nespracovaného tela spojených bodkami, vytvorený Vaším podpisovacím kľúčom. Môže ich byť viac, oddelených medzerami. Prijmite doručenie, ak sa zhoduje ktorýkoľvek z nich.

Podpisovací kľúč

Začína sa na whsec_. To odstráňte a zvyšok dekódujte z base64: tieto bajty sú kľúč HMAC, nie text, ktorý ste skopírovali. Zobrazí sa raz, keď pripojíte webhook alebo stlačíte "New signing key" na stránke Publishing, a nikdy ho neposielame.

Skontrolujte nespracované telo

Vypočítajte podpis z bajtov presne tak, ako prišli, skôr než ich čokoľvek spracuje. JSON, ktorý bol dekódovaný a znovu zakódovaný, nie sú tie isté bajty a jeho podpis sa nebude zhodovať.

PHP

<?php
$raw = getenv('SEONIS_SIGNING_KEY'); // whsec_...

// No key, no deliveries. A missing or empty variable would otherwise become
// an empty HMAC key, and anybody can sign with that.
$secret = is_string($raw) && str_starts_with($raw, 'whsec_')
    ? base64_decode(substr($raw, strlen('whsec_')), true)
    : false;

if ($secret === false || strlen($secret) < 24) {
    http_response_code(500);
    exit('Signing key not configured.');
}

$id        = $_SERVER['HTTP_WEBHOOK_ID'] ?? '';
$timestamp = $_SERVER['HTTP_WEBHOOK_TIMESTAMP'] ?? '';
$header    = $_SERVER['HTTP_WEBHOOK_SIGNATURE'] ?? '';
$body      = file_get_contents('php://input');

if (! ctype_digit($timestamp) || abs(time() - (int) $timestamp) > 300) {
    http_response_code(401);
    exit('Too old.');
}

$expected = base64_encode(hash_hmac('sha256', "$id.$timestamp.$body", $secret, true));

$valid = false;
foreach (explode(' ', $header) as $signature) {
    [$version, $value] = array_pad(explode(',', $signature, 2), 2, '');
    $valid = $valid || ($version === 'v1' && hash_equals($expected, $value));
}

if (! $valid) {
    http_response_code(401);
    exit('Bad signature.');
}

$delivery = json_decode($body, true);

Node.js

import crypto from 'node:crypto';
import express from 'express';

const app = express();

// No key, no server. An empty variable would otherwise become an empty HMAC
// key, and anybody can sign with that.
const raw = process.env.SEONIS_SIGNING_KEY ?? '';
if (!raw.startsWith('whsec_')) throw new Error('SEONIS_SIGNING_KEY is not set.');
const key = Buffer.from(raw.slice('whsec_'.length), 'base64');
if (key.length < 24) throw new Error('SEONIS_SIGNING_KEY is not a valid key.');

// express.raw keeps the body as the bytes we signed.
app.post('/hooks/seonis', express.raw({ type: 'application/json' }), (req, res) => {
  const id = req.get('webhook-id') ?? '';
  const timestamp = req.get('webhook-timestamp') ?? '';
  const header = req.get('webhook-signature') ?? '';

  if (!/^\d+$/.test(timestamp) || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) {
    return res.status(401).send('Too old.');
  }

  const expected = crypto.createHmac('sha256', key)
    .update(`${id}.${timestamp}.`)
    .update(req.body)
    .digest();

  const valid = header.split(' ').some((signature) => {
    const [version, value = ''] = signature.split(',');
    const given = Buffer.from(value, 'base64');
    return version === 'v1' && given.length === expected.length && crypto.timingSafeEqual(given, expected);
  });

  if (!valid) return res.status(401).send('Bad signature.');

  const delivery = JSON.parse(req.body);
  res.json({ ok: true });
});

Alebo použite knižnicu

Oficiálne knižnice Standard Webhooks pre PHP, JavaScript, Python, Go, Ruby a ďalšie toto všetko urobia jedným volaním. Dajte im podpisovací kľúč presne tak, ako sa Vám zobrazil, vrátane whsec_. github.com/standard-webhooks

Staršie hlavičky

Doručenia nesú aj podpisovací tajný kľúč ako bearer token a X-AutoSEO-LT-Signature, teda HMAC len tela vytvorený týmto tajným kľúčom. Stále sa posielajú, aby endpointy, ktoré sú na nich postavené, fungovali ďalej. Nový endpoint by mal namiesto toho overovať webhook-signature: starý podpis nepokrýva čas ani id a jeho kľúč sa posiela v každej požiadavke.

Formáty AutoSEO, Outrank a BabyLoveGrowth posielajú presne to, čo poslali tieto služby, takže tieto hlavičky nenesú.