Автопублікація SEO-блогу через ApiX-Drive

ApiX-Drive пов’язує чотири дії Blogent з наявною CMS. Сценарій передає кінцевий результат через отриманий захищений callback; початкове приймання webhook залишає Blogent у стані очікування.

Як підключити Blogent до ApiX-Drive

ApiX-Drive

Webhook-сценарій із кінцевим захищеним callback для кожної дії Blogent.

Реалізуйте чотири дії Blogent та повертайте кінцеві результати. Zapier, Albato й ApiX-Drive потребують захищеного callback; приймання webhook не підтверджує публікацію.

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

  1. Створіть джерело Webhook і сценарій для системи призначення. Вкажіть URL у Blogent та оберіть ApiX-Drive.
  2. Розгалужуйте сценарій за action: inventory повертає наявні статті й next_cursor; read — повний snapshot; create/update — відповідну дію CMS.
  3. Для запису потрібен транзакційний адаптер CMS із журналом operation_id та атомарною перевіркою expected_revision. При оновленні зберігайте ID, URL, дати, авторів і ресурси; не виконуйте сліпий upsert за alias.
  4. Додайте Webhooks → Send DATA (Custom) останнім кроком callback. Збережіть request_id, callback_url і callback_token. Останній HTTP POST надсилає на callback_url заголовок Authorization: Bearer callback_token і JSON {contract_version:"2.0",request_id,action,result}. У разі помилки надішліть явний невдалий результат.
  5. Запустіть тест: inventory, створення, захищене читання й оновлення тієї самої статті. Стандартне підтвердження приймання або частковий результат не завершують тест.
Офіційна документація платформи

Документація HTTP-дії для callback

Якщо ви підключаєтеся через Zapier, Albato або ApiX-Drive

  1. Цей розділ стосується підключень через ці три платформи. Власний webhook повертає результат у відповіді на запит. Для сценарію з чергою виберіть потрібну платформу в налаштуваннях інтеграції.
  2. Кожна дія містить request_id, callback_url і callback_token. Збережіть їх на всіх кроках сценарію. Виконуйте дію у своїй CMS із тими самими правилами збереження, повторів і перевірки версій.
  3. Після завершення надішліть POST на отриманий callback URL із заголовком Authorization: Bearer <callback_token>. Тіло: {contract_version:"2.0",request_id,action,result}, де result — повна відповідь виконаної дії.
  4. У разі помилки надішліть result:{posted:false,message:"reason",status:409} із відповідним кодом 4xx/5xx. Не підтверджуйте успіх, якщо статтю збережено лише частково.
  5. Callback діє одну годину й прив’язаний до запиту, дії та налаштувань. Однакові повтори приймаються; змінений результат повертає 409, неправильний токен — 401, прострочений запит — 410. Система може повторити запит до п’яти разів з інтервалом щонайменше дві хвилини. Усуньте дублювання за request_id та operation_id.
  6. Тест підключення чекає callback на кожному кроці: inventory → create → read → update → read. Останнє читання перевіряє збережені зміни. Окремо перевірте неправильні токени, повторні callback і прострочені запити.

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

  • 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.

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

  • Читайте наявний архів і повні snapshot перед плануванням нових статей.
  • Оновлюйте статті зі збереженням ID, URL, первинних дат, авторів і ресурсів.
  • Безпечно повторюйте ідентичні операції та відхиляйте застарілі ревізії чи змінені повтори.

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

Дії
Реалізуйте inventory, read, create та update для наявної CMS із явними мовними мапінгами.
Конкурентність
Транзакційний адаптер із постійним журналом operation_id та атомарною перевіркою expected_revision. Окремих no-code upsert недостатньо.
Завершення
POST кінцевого результату на callback_url із заголовком Authorization: Bearer callback_token. Збережіть request_id та action.

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

Чи підтверджує приймання webhook публікацію?

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

Що робить тест з’єднання?

Inventory, create, захищене read та update тієї самої реальної статті. Він очікує callback без обходу публічної сторінки.

Як захищені повтори та редагування?

CMS постійно зберігає ID операції, хеш запиту й відповідь. Ідентичний повтор повертає її; змінений повтор або застаріла ревізія дає 409. Ручні зміни також мають змінювати ревізію.

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

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