Підключіть сайт через webhook

Blogent публікує повні статті та оновлює наявні сторінки за URL. Ваш сайт показує статтю, SEO-метадані й дату оновлення, зокрема dateModified у структурованих даних.

Перехід на V2
На цій сторінці
  1. Створіть обробник GET, POST і PUT за прикладами нижче.
  2. У налаштуваннях вебхука вкажіть URL обробника та секретний заголовок.
  3. Запустіть тест і ввімкніть публікацію.

1. Створення статті: вхідний JSON через POST

Blogent надсилає цей JSON для створення статті. Збережіть кожну передану мову. Лише після збереження поверніть HTTP 200 зі справжньою публічною адресою: {"url":"https://site.example/blog/article-en"}.

POST JSON
{
    "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 у структурованих даних.

PUT JSON
{
    "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 працює з актуальним текстом і перевіряє збережене оновлення. Інші поля верхнього рівня не потрібні.

GET JSON
{
    "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Обов’язковеstringSlug цієї мовної версії, наприклад article-en. Під час оновлення він не змінюється; GET повертає збережене значення.
article.*.titleОбов’язковеstringВидимий заголовок статті.
article.*.previewОбов’язковеstring (HTML)HTML-анонс для списку статей; може бути порожнім рядком.
article.*.textОбов’язковеstring (HTML)Повний HTML: TL;DR, посилання, зображення в тексті, таблиці, відео, FAQ і шорткоди.
article.*.meta_title / meta_descriptionОбов’язковеstringSEO-заголовок та опис; можуть бути порожніми рядками.
article.*.tocОпциональноarrayЗміст: id, title, level. Порожній масив означає відсутність змісту.
article.*.reading_time_minutesОпциональноintegerЧас читання у хвилинах.
dateОпциональноstring (date/time)Дата публікації; під час оновлення зберігайте початкову.
modified_atОпциональноstring (date/time)Час останнього оновлення; покажіть його та використайте в dateModified.
imageОпциональноstring | null | falseURL обкладинки. Збережіть її постійно. null — без обкладинки; false — вибір із явно заданої image_category.
image_categoryОпциональноstringЯвно налаштоване джерело зображень вашого сайту, якщо image — false.
author_idОпциональноstring | integerID вибраного автора на вашому сайті з необов’язкового списку авторів.
rubric / paramsОпциональноstringНалаштована рубрика та параметри товарів.

Якщо ви використовуєте params, збережіть передані атрибути для фільтрів каталогу або рекомендацій. Зберігайте синтаксис, налаштований для вашого сайту, наприклад key:value1|value2;.

Опционально: автори з вашого сайту

Якщо Blogent має вибирати автора, додайте GET /your-endpoint?authors=1 із тим самим секретним заголовком. Поверніть ID та повні імена наявних авторів. У Blogent завантажте цей список, виберіть авторів і додайте посаду та короткий опис — за ними система вибере відповідного автора для теми. Під час створення передається лише author_id, ID із вашого сайту. Без цього запиту автора призначає сам сайт.

GET JSON
{
    "authors": [
        {
            "id": "42",
            "name": "Olena Kovalenko"
        },
        {
            "id": "73",
            "name": "Taras Melnyk"
        }
    ]
}

Відповіді та помилки

Повертайте JSON із Content-Type: application/json. Успішний POST або PUT повертає публічну адресу, успішний GET — article або authors. Підтверджуйте успіх лише після збереження всіх переданих мов.

HTTPJSONЩо означає
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.

Форми та інші блоки всередині статей

Якщо ваш сайт підтримує шорткоди, у статтю можна додати форму, банер або блок товарів.

  1. Вкажіть шорткод у налаштуваннях SEO-блогу. Blogent розмістить його в статті під час генерації.
  2. Webhook зберігає його без змін. Шаблон або плагін вашого сайту перетворює шорткод на відповідний блок.
  3. Використовуйте точну назву й параметри, які підтримує ваш сайт.
  • Контактна форма: [contact-form]
  • Слайдер товарів: [products_slider category="chairs"]
  • Заклик до дії: [cta]
  • Промокод: [promo_code]
  • Добірка товарів: [featured_products]
  • Банер або інформаційний блок: [info_banner]

Це лише приклади назв. Якщо сайт не розпізнає шорткод, спочатку додайте його підтримку в шаблоні або плагіні.

Приклади обробника

Виберіть мову сервера. Приклади обробляють HTTP-запити й перевіряють секрет; підключіть позначені функції читання та збереження до свого сховища статей. Поки їх не реалізовано, приклади повертають помилку. Отримання авторів необов’язкове.

PHP
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()]);
}

Що перевірити перед запуском

  1. Неправильний секрет не має відкривати доступ до статей або змінювати дані.
  2. Створіть, прочитайте, оновіть і знову прочитайте ту саму статтю кожною переданою мовою. Порівняйте повний HTML, TL;DR, зображення в тексті, preview, SEO-поля, зміст і час читання. URL, початкова дата, обкладинка й автор мають залишитися незмінними; дубліката бути не повинно.
  3. На сторінці перевірте посилання змісту, медіа, метатеги й видиму дату оновлення. Перевірте dateModified у структурованих даних.

Перевірте підключення

Тест створює одну статтю, читає її, оновлює та читає знову. Він порівнює кожну передану мову, повний HTML, SEO-поля, зміст і час читання. Тестова стаття залишиться на сайті.

JSON можна редагувати. Тест додає унікальний суфікс до alias, щоб не перезаписати наявну статтю. За потреби додайте інші мови або справжній author_id.

Переведіть блог на автопілот

Підключіть сайт і поділіться знаннями. Далі Blogent працює сам.