Підключіть сайт через webhook
Blogent публікує повні статті та оновлює наявні сторінки за URL. Ваш сайт показує статтю, SEO-метадані й дату оновлення, зокрема dateModified у структурованих даних.
На цій сторінці
- Створіть обробник GET, POST і PUT за прикладами нижче.
- У налаштуваннях вебхука вкажіть URL обробника та секретний заголовок.
- Запустіть тест і ввімкніть публікацію.
1. Створення статті: вхідний JSON через POST
Blogent надсилає цей JSON для створення статті. Збережіть кожну передану мову. Лише після збереження поверніть HTTP 200 зі справжньою публічною адресою: {"url":"https://site.example/blog/article-en"}.
{
"alias": "article",
"date": "2026-10-14 12:00:00",
"modified_at": "2026-10-14 12:00:00",
"image": "https://your-site.example/images/article-cover.webp",
"image_category": "",
"rubric": "guides",
"params": "topic:blog|seo;",
"article": {
"en": {
"title": "How to plan a useful blog article",
"alias": "article-en",
"preview": "<p>A practical guide to planning an article.</p>",
"meta_title": "Plan a useful blog article",
"meta_description": "Learn how to plan article structure and choose useful examples.",
"reading_time_minutes": 1,
"toc": [
{
"id": "main-section",
"title": "Plan the structure",
"level": 2
},
{
"id": "nested-point",
"title": "Choose useful examples",
"level": 3
}
],
"text": "<div class=\"blgn-article\"><p class=\"blgn-tldr\"><strong>TLDR:</strong> Plan the structure before writing and keep the advice practical.</p><h2 id=\"main-section\">Plan the structure</h2><p>Start with the reader’s question and a clear answer.</p><h3 id=\"nested-point\">Choose useful examples</h3><p>Use examples from your actual workflow.</p><img src=\"https://your-site.example/images/article-example.webp\" alt=\"Example article outline\" loading=\"lazy\"><p><a href=\"https://your-site.example/guides\" rel=\"noopener\" target=\"_blank\">More guides</a></p></div>"
}
},
"author_id": "42"
}2. Оновлення статті: вхідний JSON через PUT
Знайдіть статтю за точною публічною url. Замініть переданий вміст кожною мовою та поверніть ту саму адресу. Збережіть slug, зв’язки перекладів, початкову дату публікації, обкладинку, автора, рубрику й параметри товарів. Збережіть modified_at, покажіть дату оновлення на сторінці та вкажіть dateModified у структурованих даних.
{
"url": "https://your-site.example/blog/article-en",
"modified_at": "2026-10-15 09:00:00",
"article": {
"en": {
"title": "How to plan a useful blog article",
"preview": "<p>A practical guide to planning an article.</p>",
"meta_title": "Plan a useful blog article",
"meta_description": "Updated advice on article structure, examples and review.",
"reading_time_minutes": 1,
"toc": [
{
"id": "main-section",
"title": "Plan the structure",
"level": 2
},
{
"id": "nested-point",
"title": "Choose useful examples",
"level": 3
}
],
"text": "<div class=\"blgn-article\"><p class=\"blgn-tldr\"><strong>TLDR:</strong> Keep a clear structure and update the advice when your process changes.</p><h2 id=\"main-section\">Plan the structure</h2><p>Start with the reader’s question and a clear answer.</p><h3 id=\"nested-point\">Choose useful examples</h3><p>Use examples from your actual workflow.</p><img src=\"https://your-site.example/images/article-example.webp\" alt=\"Example article outline\" loading=\"lazy\"><p><a href=\"https://your-site.example/guides\" rel=\"noopener\" target=\"_blank\">More guides</a></p></div>"
}
}
}3. Повернення поточної статті на запит Blogent
Blogent надсилає GET /your-endpoint?url=https%3A%2F%2Fsite.example%2Fblog%2Farticle-en. Знайдіть цю сторінку та поверніть {"article":{...}} зі збереженим вмістом кожною мовою, як нижче. Так Blogent працює з актуальним текстом і перевіряє збережене оновлення. Інші поля верхнього рівня не потрібні.
{
"article": {
"en": {
"title": "How to plan a useful blog article",
"alias": "article-en",
"preview": "<p>A practical guide to planning an article.</p>",
"meta_title": "Plan a useful blog article",
"meta_description": "Learn how to plan article structure and choose useful examples.",
"reading_time_minutes": 1,
"toc": [
{
"id": "main-section",
"title": "Plan the structure",
"level": 2
},
{
"id": "nested-point",
"title": "Choose useful examples",
"level": 3
}
],
"text": "<div class=\"blgn-article\"><p class=\"blgn-tldr\"><strong>TLDR:</strong> Plan the structure before writing and keep the advice practical.</p><h2 id=\"main-section\">Plan the structure</h2><p>Start with the reader’s question and a clear answer.</p><h3 id=\"nested-point\">Choose useful examples</h3><p>Use examples from your actual workflow.</p><img src=\"https://your-site.example/images/article-example.webp\" alt=\"Example article outline\" loading=\"lazy\"><p><a href=\"https://your-site.example/guides\" rel=\"noopener\" target=\"_blank\">More guides</a></p></div>"
}
}
}Які поля обробляти
«Обов’язкове» — поле має бути в запиті. «Опционально» — збережіть його, якщо передано. «—» — поле не надсилається. Обробляйте кожну мову в article; адреси перекладів визначає ваш сайт.
| Поле | Тип | Опис |
|---|---|---|
articleОбов’язкове | object | Повний вміст за мовами: article.en, article.uk тощо. |
aliasОбов’язкове | string | Спільний ключ статті для створення. За ним перевіряйте, що повтор не створює дублікат. |
article.*.aliasОбов’язкове | string | Slug цієї мовної версії, наприклад article-en. Під час оновлення він не змінюється; GET повертає збережене значення. |
article.*.titleОбов’язкове | string | Видимий заголовок статті. |
article.*.previewОбов’язкове | string (HTML) | HTML-анонс для списку статей; може бути порожнім рядком. |
article.*.textОбов’язкове | string (HTML) | Повний HTML: TL;DR, посилання, зображення в тексті, таблиці, відео, FAQ і шорткоди. |
article.*.meta_title / meta_descriptionОбов’язкове | string | SEO-заголовок та опис; можуть бути порожніми рядками. |
article.*.tocОпционально | array | Зміст: id, title, level. Порожній масив означає відсутність змісту. |
article.*.reading_time_minutesОпционально | integer | Час читання у хвилинах. |
dateОпционально | string (date/time) | Дата публікації; під час оновлення зберігайте початкову. |
modified_atОпционально | string (date/time) | Час останнього оновлення; покажіть його та використайте в dateModified. |
imageОпционально | string | null | false | URL обкладинки. Збережіть її постійно. null — без обкладинки; false — вибір із явно заданої image_category. |
image_categoryОпционально | string | Явно налаштоване джерело зображень вашого сайту, якщо image — false. |
author_idОпционально | string | integer | ID вибраного автора на вашому сайті з необов’язкового списку авторів. |
rubric / paramsОпционально | string | Налаштована рубрика та параметри товарів. |
| Поле | Тип | Опис |
|---|---|---|
articleОбов’язкове | object | Повний вміст за мовами: article.en, article.uk тощо. |
urlОбов’язкове | string | Повна публічна адреса для пошуку статті. GET передає її в query; оновлення — на початку JSON. |
article.*.titleОбов’язкове | string | Видимий заголовок статті. |
article.*.previewОбов’язкове | string (HTML) | HTML-анонс для списку статей; може бути порожнім рядком. |
article.*.textОбов’язкове | string (HTML) | Повний HTML: TL;DR, посилання, зображення в тексті, таблиці, відео, FAQ і шорткоди. |
article.*.meta_title / meta_descriptionОбов’язкове | string | SEO-заголовок та опис; можуть бути порожніми рядками. |
article.*.tocОпционально | array | Зміст: id, title, level. Порожній масив означає відсутність змісту. |
article.*.reading_time_minutesОпционально | integer | Час читання у хвилинах. |
modified_atОпционально | string (date/time) | Час останнього оновлення; покажіть його та використайте в dateModified. |
| Поле | Тип | Опис |
|---|---|---|
articleОбов’язкове | object | Повний вміст за мовами: article.en, article.uk тощо. |
article.*.aliasОбов’язкове | string | Slug цієї мовної версії, наприклад article-en. Під час оновлення він не змінюється; GET повертає збережене значення. |
article.*.titleОбов’язкове | string | Видимий заголовок статті. |
article.*.previewОбов’язкове | string (HTML) | HTML-анонс для списку статей; може бути порожнім рядком. |
article.*.textОбов’язкове | string (HTML) | Повний HTML: TL;DR, посилання, зображення в тексті, таблиці, відео, FAQ і шорткоди. |
article.*.meta_title / meta_descriptionОбов’язкове | string | SEO-заголовок та опис; можуть бути порожніми рядками. |
article.*.tocОпционально | array | Зміст: id, title, level. Порожній масив означає відсутність змісту. |
article.*.reading_time_minutesОпционально | integer | Час читання у хвилинах. |
Якщо ви використовуєте params, збережіть передані атрибути для фільтрів каталогу або рекомендацій. Зберігайте синтаксис, налаштований для вашого сайту, наприклад key:value1|value2;.
Відповіді та помилки
Повертайте JSON із Content-Type: application/json. Успішний POST або PUT повертає публічну адресу, успішний GET — article або authors. Підтверджуйте успіх лише після збереження всіх переданих мов.
| HTTP | JSON | Що означає |
|---|---|---|
| 200 POST / PUT | {"url":"https://site.example/blog/article-en"} | Статтю збережено; поверніть її справжню адресу. |
| 200 GET | {"article":{...}} / {"authors":[...]} | Збережена стаття або список авторів. |
| 500 | {"error":"Article not found at the requested URL"} | Будь-яка помилка: опишіть конкретну причину в error. |
Відображення статті на сайті
Blogent надсилає готовий HTML. Зберігайте його без переписування. Стилі задайте в шаблоні статті на своєму сайті.
Обгортка — .blgn-article; короткий підсумок TL;DR — p.blgn-tldr всередині text. Медіа використовують .blgn-media, .blgn-image, .blgn-video; шорткоди — .blgn-shortcode.
Підтримайте заголовки h1–h4, абзаци, списки, посилання, зображення, таблиці, цитати, код, iframe/video та FAQ із details/summary. Зберігайте ID заголовків, атрибути медіа, rel/target посилань і адаптивні обгортки.
Показуйте toc як посилання на ID заголовків у text, а reading_time_minutes — як час читання. Використовуйте meta_title/meta_description у метатегах сторінки.
Покажіть дату оновлення статті на сторінці та вкажіть dateModified у структурованих даних. Початкова дата залишається в datePublished.
Форми та інші блоки всередині статей
Якщо ваш сайт підтримує шорткоди, у статтю можна додати форму, банер або блок товарів.
- Вкажіть шорткод у налаштуваннях SEO-блогу. Blogent розмістить його в статті під час генерації.
- Webhook зберігає його без змін. Шаблон або плагін вашого сайту перетворює шорткод на відповідний блок.
- Використовуйте точну назву й параметри, які підтримує ваш сайт.
- Контактна форма:
[contact-form] - Слайдер товарів:
[products_slider category="chairs"] - Заклик до дії:
[cta] - Промокод:
[promo_code] - Добірка товарів:
[featured_products] - Банер або інформаційний блок:
[info_banner]
Це лише приклади назв. Якщо сайт не розпізнає шорткод, спочатку додайте його підтримку в шаблоні або плагіні.
Приклади обробника
Виберіть мову сервера. Приклади обробляють HTTP-запити й перевіряють секрет; підключіть позначені функції читання та збереження до свого сховища статей. Поки їх не реалізовано, приклади повертають помилку. Отримання авторів необов’язкове.
declare(strict_types=1);
// Connect these functions to your website's existing article storage.
function listAuthors(): array
{
// Optional: return ['authors' => [['id' => '42', 'name' => 'Full Name']]] from your site.
throw new DomainException('Author list is not implemented');
}
function readArticle(string $url): array
{
// Find by the exact public URL and return the saved article fields.
// Return ['article' => $savedLanguages] including aliases and all supplied article fields.
// If the article does not exist, throw an error explaining the cause.
throw new LogicException('Connect the website article read here.');
}
function saveArticle(array $data, string $method): array
{
// POST: create. PUT: update the page identified by url; never create another.
// Save all supplied languages and return ['url' => $publicUrl].
// On update, keep the URL, original date, author and existing images.
// Repeated creation with the same alias must not create a duplicate.
throw new LogicException('Connect the website article save here.');
}
header('Content-Type: application/json; charset=utf-8');
$secret = getenv('BLOG_WEBHOOK_TOKEN');
$token = $_SERVER['HTTP_X_WEBHOOK_TOKEN'] ?? '';
if (!is_string($secret) || strlen($secret) < 32 || !hash_equals($secret, $token)) {
http_response_code(500);
echo json_encode(['error' => 'Unauthorized']);
exit;
}
try {
$method = $_SERVER['REQUEST_METHOD'] ?? '';
if ($method === 'GET') {
$url = $_GET['url'] ?? null;
if (($_GET['authors'] ?? '') !== '1' && (!is_string($url) || !filter_var($url, FILTER_VALIDATE_URL))) throw new InvalidArgumentException('Public URL required');
$result = ($_GET['authors'] ?? '') === '1' ? listAuthors() : readArticle($url);
} elseif ($method === 'POST' || $method === 'PUT') {
if (!str_starts_with(strtolower($_SERVER['CONTENT_TYPE'] ?? ''), 'application/json')) throw new InvalidArgumentException('JSON required');
$body = file_get_contents('php://input');
if (!is_string($body) || strlen($body) > 4 * 1024 * 1024) throw new InvalidArgumentException('Payload too large');
$data = json_decode($body, true, flags: JSON_THROW_ON_ERROR);
if (!is_array($data) || !is_array($data['article'] ?? null) || $data['article'] === []) throw new InvalidArgumentException('Article required');
if ($method === 'PUT' && (!is_string($data['url'] ?? null) || !filter_var($data['url'], FILTER_VALIDATE_URL))) throw new InvalidArgumentException('Public URL required for PUT');
if ($method === 'POST' && array_key_exists('url', $data)) throw new InvalidArgumentException('POST creates articles; use PUT to update');
$result = saveArticle($data, $method);
} else {
http_response_code(500);
header('Allow: GET, POST, PUT');
echo json_encode(['error' => 'GET, POST or PUT required']);
exit;
}
echo json_encode($result, JSON_THROW_ON_ERROR);
} catch (Throwable $error) {
http_response_code(500);
echo json_encode(['error' => $error->getMessage()]);
}import { createServer } from 'node:http';
import { timingSafeEqual } from 'node:crypto';
// Connect these functions to your existing website storage.
async function readArticle(url) {
// Find by the exact public URL; return { article: savedLanguages }.
// Include saved aliases and every supplied article field. Missing page: throw an error with the cause.
throw new Error('Connect your article reader');
}
async function saveArticle(data, method) {
// POST: create. PUT: update the page identified by url; missing page: throw an error with the cause.
// Save every supplied language, then return { url: actualPublicUrl }.
// Keep slugs, original date, author, cover and translations on updates.
// Save modified_at and display it on the page and in dateModified.
// Repeated create with the same alias must not create a duplicate.
throw new Error('Connect your article writer');
}
async function listAuthors() {
// Optional: return { authors: [{ id: '42', name: 'Full Name' }] } from your site.
throw new Error('Author list is not implemented');
}
const secret = process.env.BLOG_WEBHOOK_TOKEN;
if (!secret || secret.length < 32) throw new Error('Configure BLOG_WEBHOOK_TOKEN');
const fail = message => { throw new Error(message); };
const publicUrl = value => {
try { return typeof value === 'string' && ['http:', 'https:'].includes(new URL(value).protocol); }
catch { return false; }
};
createServer(async (req, res) => {
const respond = (status, body) => {
res.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' });
res.end(JSON.stringify(body));
};
const token = Buffer.from(req.headers['x-webhook-token'] || '');
const expected = Buffer.from(secret);
if (token.length !== expected.length || !timingSafeEqual(token, expected)) return respond(500, { error: 'Unauthorized' });
try {
const query = new URL(req.url, 'http://localhost').searchParams;
let result;
if (req.method === 'GET') {
if (query.get('authors') === '1') result = await listAuthors();
else {
if (!publicUrl(query.get('url'))) fail('Public URL required');
result = await readArticle(query.get('url'));
}
} else if (req.method === 'POST' || req.method === 'PUT') {
if (!(req.headers['content-type'] || '').startsWith('application/json')) fail('JSON required');
const chunks = []; let size = 0;
for await (const chunk of req) {
size += chunk.length;
if (size > 4 * 1024 * 1024) fail('Payload too large');
chunks.push(chunk);
}
let data;
try { data = JSON.parse(Buffer.concat(chunks).toString()); }
catch { fail('Invalid JSON'); }
if (!data?.article || typeof data.article !== 'object' || Array.isArray(data.article) || !Object.keys(data.article).length) fail('Article required');
if (req.method === 'PUT' && !publicUrl(data.url)) fail('Public URL required for PUT');
if (req.method === 'POST' && 'url' in data) fail('POST creates articles; use PUT to update');
result = await saveArticle(data, req.method);
} else {
res.setHeader('Allow', 'GET, POST, PUT');
return respond(500, { error: 'GET, POST or PUT required' });
}
respond(200, result);
} catch (error) {
respond(500, { error: error.message });
}
}).listen(process.env.PORT || 3000);
import hmac
import json
import os
from http.server import BaseHTTPRequestHandler, HTTPServer
from urllib.parse import parse_qs, urlparse
# Connect these functions to your existing website storage.
def read_article(url):
# Find by exact public URL; return {"article": saved_languages}.
# Include saved aliases and every supplied article field. Missing page: raise an error with the cause.
raise NotImplementedError("Connect your article reader")
def save_article(data, method):
# POST: create. PUT: update the page identified by url; missing page: raise an error with the cause.
# Save every language, then return {"url": actual_public_url}.
# Keep slugs, original date, author, cover and translations on updates.
# Save modified_at and show it on the page and in dateModified.
# Repeated create with the same alias must not create a duplicate.
raise NotImplementedError("Connect your article writer")
def list_authors():
# Optional: return {"authors": [{"id": "42", "name": "Full Name"}]} from your site.
raise RequestError("Author list is not implemented")
class RequestError(Exception):
pass
secret = os.environ.get("BLOG_WEBHOOK_TOKEN", "")
if len(secret) < 32:
raise RuntimeError("Configure BLOG_WEBHOOK_TOKEN")
def public_url(value):
if not isinstance(value, str):
return False
parsed = urlparse(value)
return parsed.scheme in ("http", "https") and bool(parsed.netloc)
class Handler(BaseHTTPRequestHandler):
def respond(self, status, body):
self.send_response(status)
self.send_header("Content-Type", "application/json; charset=utf-8")
self.end_headers()
self.wfile.write(json.dumps(body, ensure_ascii=False).encode())
def handle_request(self):
if not hmac.compare_digest(secret.encode(), self.headers.get("X-Webhook-Token", "").encode()):
return self.respond(500, {"error": "Unauthorized"})
try:
if self.command == "GET":
query = parse_qs(urlparse(self.path).query)
if query.get("authors") == ["1"]:
result = list_authors()
else:
url = query.get("url", [None])[0]
if not public_url(url):
raise RequestError("Public URL required")
result = read_article(url)
else:
if not self.headers.get("Content-Type", "").startswith("application/json"):
raise RequestError("JSON required")
size = int(self.headers.get("Content-Length", "0"))
if size < 1 or size > 4 * 1024 * 1024:
raise RequestError("Invalid payload size")
data = json.loads(self.rfile.read(size))
if not isinstance(data, dict) or not isinstance(data.get("article"), dict) or not data["article"]:
raise RequestError("Article required")
if self.command == "PUT" and not public_url(data.get("url")):
raise RequestError("Public URL required for PUT")
if self.command == "POST" and "url" in data:
raise RequestError("POST creates articles; use PUT to update")
result = save_article(data, self.command)
self.respond(200, result)
except Exception as error:
self.respond(500, {"error": str(error)})
def send_error(self, code, message=None, explain=None):
self.respond(500, {"error": message or "Request could not be processed"})
do_GET = handle_request
do_POST = handle_request
do_PUT = handle_request
HTTPServer(("127.0.0.1", int(os.environ.get("PORT", "3000"))), Handler).serve_forever()
Що перевірити перед запуском
- Неправильний секрет не має відкривати доступ до статей або змінювати дані.
- Створіть, прочитайте, оновіть і знову прочитайте ту саму статтю кожною переданою мовою. Порівняйте повний HTML, TL;DR, зображення в тексті, preview, SEO-поля, зміст і час читання. URL, початкова дата, обкладинка й автор мають залишитися незмінними; дубліката бути не повинно.
- На сторінці перевірте посилання змісту, медіа, метатеги й видиму дату оновлення. Перевірте dateModified у структурованих даних.
Перевірте підключення
Тест створює одну статтю, читає її, оновлює та читає знову. Він порівнює кожну передану мову, повний HTML, SEO-поля, зміст і час читання. Тестова стаття залишиться на сайті.
Схожі інтеграції
Переведіть блог на автопілот
Підключіть сайт і поділіться знаннями. Далі Blogent працює сам.