Перехід на V2

Одна адреса: POST створює, PUT оновлює, GET читає. Адреса статті і є її ідентифікатором.

Що змінюється

Збереження

Після збереження поверніть {"url":"https://site.example/blog/article"} зі справжньою публічною адресою статті.

Редагування

Blogent надсилає PUT із url статті та новим вмістом. Знайдіть сторінку за цією адресою й оновіть її.

Читання

GET за url повертає {"article":{...}} зі збереженими полями.

Класи HTML

Додайте стилі для .blgn-article, .blgn-tldr, .blgn-media, .blgn-image, .blgn-video та .blgn-shortcode у шаблоні статті.

Автори (необов’язково)

Додайте GET ?authors=1 зі списком ID та імен авторів сайту. Blogent завантажує їх і передає лише author_id під час створення.

Оновіть свій обробник

1. Повертайте публічну URL після створення.

   Залиште свій код створення через POST і всі поля статті. Після збереження поверніть справжню публічну адресу.

2. Додайте PUT для оновлення.

   Знайдіть сторінку за url і замініть передані поля кожною мовою. Alias та urls для заміни не надсилаються. Збережіть URL, slug, переклади й початкові дані публікації. Збережіть modified_at і покажіть дату оновлення на сторінці та в dateModified. Якщо URL не знайдено, поверніть 500 з описом помилки.

3. Повертайте збережену статтю на GET.

   Повертайте лише {"article":{...}}: усі збережені мови, їхні alias, HTML, preview, SEO-поля, зміст і час читання. GET, POST і PUT перевіряють той самий секретний заголовок.

4. Запустіть тест підключення.

   Створіть, оновіть і прочитайте одну статтю тестом нижче. Порівняйте всі поля та кожну мову. Перевірте видиму дату оновлення й dateModified.

Запит на оновлення: PUT із url

Передайте наявну публічну адресу статті в url і повний оновлений вміст нижче. Початкові обкладинка, автор, дата публікації, рубрика й параметри товарів залишаються в сховищі сайту.

{
    "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>"
        }
    }
}

Готово: POST створює сторінку, PUT оновлює, GET читає. Публічна URL не змінюється.