AI SEO-блог для Strapi
Пакет додає у ваш проєкт Strapi один захищений endpoint публікації. Він перевіряє вхідні дані та заголовок авторизації, завантажує обкладинку в медіатеку Strapi й зберігає статті ідемпотентно, тож повторна доставка оновлює запис, а не створює дубль.
Як підключити Blogent до Strapi
Пакет інтеграції для Strapi
Готовий пакет додає у ваш проєкт Strapi захищений endpoint публікації Blogent: валідацію payload, авторизацію, завантаження зображень у медіатеку та ідемпотентне збереження статей.
Налаштування
- Завантажте пакет інтеграції та додайте його у проєкт Strapi за README з архіву.
- Відкрийте Blogent у Strapi admin, оберіть цільову колекцію, явно замапте обов’язкові поля й збережіть.
- Скопіюйте webhook URL та автоматично згенерований токен авторизації зі Strapi admin.
- У дашборді 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-поля, зміст і час читання. Тестова стаття залишиться на сайті.
Що ви отримуєте після підключення 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 працює сам.