AI SEO-блог для Strapi

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

Як підключити Blogent до Strapi

Пакет інтеграції для Strapi

Готовий пакет додає у ваш проєкт Strapi захищений endpoint публікації Blogent: валідацію payload, авторизацію, завантаження зображень у медіатеку та ідемпотентне збереження статей.

Завантажити пакет для Strapi

Налаштування

  1. Завантажте пакет інтеграції та додайте його у проєкт Strapi за README з архіву.
  2. Відкрийте Blogent у Strapi admin, оберіть цільову колекцію, явно замапте обов’язкові поля й збережіть.
  3. Скопіюйте webhook URL та автоматично згенерований токен авторизації зі Strapi admin.
  4. У дашборді Blogent відкрийте Інтеграції → Strapi, вставте URL, задайте Authorization: Bearer <token> і запустіть тест з’єднання.

Тест читає наявний архів, створює одну реальну статтю, отримує захищений snapshot та оновлює ті самі нативні ID. Обхід публічних сторінок не потрібний.

Чотири дії, які має підтримувати обробник

  • inventory — список наявних статей. Приймайте cursor і limit; повертайте {articles: [snapshot], next_cursor: string|null}. Null означає, що наступної сторінки немає.
  • read — читання однієї статті з CMS. Приймайте target та/або content_id; повертайте {article_snapshot: snapshot}. Якщо передано ID у target, шукайте статтю саме за ними.
  • Snapshot — це поточні дані статті: identity, title, alias, date, article, target, revision, urls. Повертайте повний вміст усіх мовних версій. Невідому початкову дату передавайте як null; якщо URL недоступні, їхня мапа може бути порожньою.
  • create — публікація нової статті всіма переданими мовами. Запит містить унікальний operation_id, постійний content_id, порожній target і null у expected_revision. Після збереження поверніть {posted:true,target,revision,urls}.
  • update — оновлення статті за ID з target. Перед записом звірте expected_revision з її поточною версією. Збережіть ID, URL, alias, початкову дату публікації, автора й наявні медіафайли.
Універсальний контракт вебхука

Blogent підтримує inventory, захищене читання, створення та оновлення на місці. Кінцева відповідь містить нативні target ID і ревізію; асинхронні сценарії завершуються через захищений callback.

Відкрити документацію вебхука

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

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

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

Що ви отримуєте після підключення Strapi

  • Публікація ідемпотентна: та сама стаття, доставлена вдруге, оновлює наявний запис, а не створює другий.
  • Обкладинка завантажується в медіатеку Strapi, тож стаття не залежить від тимчасового зовнішнього посилання.
  • Плагін автоматично генерує токен у Strapi admin; Blogent надсилає його як Authorization: Bearer <token>.
  • Валідація payload відхиляє некоректні доставки одразу, а не записує зіпсовані записи в колекцію.
  • У пакеті є README, тож розробник додасть його в наявний проєкт без реверс-інжинірингу контракту.
  • Blogent читає наявні нативні статті та оновлює їх із перевіркою ревізії, зберігаючи ID, URL, дати, авторів і ресурси.

Вимоги та сумісність

Платформа
Проєкт Strapi, який ви можете розгортати й доповнювати кодом.
Токен
Автоматично генерується на сторінці Blogent у Strapi admin.
Endpoint
Публічний webhook URL, наприклад https://your-site.com/api/blogent/webhook.
Заголовок
Authorization: Bearer <token> із токеном, скопійованим зі Strapi admin.
Перевірка
Тест читає наявний архів, створює одну реальну статтю, отримує захищений snapshot та оновлює ті самі нативні ID. Обхід публічних сторінок не потрібний.

Часті запитання про інтеграцію з Strapi

Чи потрібно писати інтеграцію самому?

Ні. У пакеті вже є endpoint, валідація, авторизація, завантаження зображень і логіка збереження. Додайте його в проєкт, налаштуйте мапінг полів у Strapi admin і розгорніть.

Що завадить сторонньому надсилати статті на мій сайт?

Endpoint перевіряє згенерований токен із заголовка Authorization: Bearer <token>. Запити без правильного токена відхиляються.

Чи створить повторна спроба дублікати?

Ні. Збереження ідемпотентне, тож повторна доставка тієї самої статті оновлює наявний запис.

Як перевірити роботу до запуску?

Запустіть тест з’єднання в панелі Blogent. Він публікує реальну статтю з унікальним alias тим самим шляхом, що й бойовий контент, тож ви побачите її у своїй колекції Strapi.

Схожі інтеграції

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

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