Автопублікація 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 не підтверджує публікацію.
Тест створює й оновлює одну реальну статтю. Приймання в чергу залишає стан очікування до захищеного кінцевого результату кожної дії.
- Створіть джерело Webhook і сценарій для системи призначення. Вкажіть URL у Blogent та оберіть ApiX-Drive.
- Розгалужуйте сценарій за
action: inventory повертає наявні статті й next_cursor; read — повний snapshot; create/update — відповідну дію CMS. - Для запису потрібен транзакційний адаптер CMS із журналом operation_id та атомарною перевіркою expected_revision. При оновленні зберігайте ID, URL, дати, авторів і ресурси; не виконуйте сліпий upsert за alias.
- Додайте 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}. У разі помилки надішліть явний невдалий результат.
- Запустіть тест: inventory, створення, захищене читання й оновлення тієї самої статті. Стандартне підтвердження приймання або частковий результат не завершують тест.
Якщо ви підключаєтеся через Zapier, Albato або ApiX-Drive
- Цей розділ стосується підключень через ці три платформи. Власний webhook повертає результат у відповіді на запит. Для сценарію з чергою виберіть потрібну платформу в налаштуваннях інтеграції.
- Кожна дія містить
request_id,callback_urlіcallback_token. Збережіть їх на всіх кроках сценарію. Виконуйте дію у своїй CMS із тими самими правилами збереження, повторів і перевірки версій. - Після завершення надішліть POST на отриманий callback URL із заголовком
Authorization: Bearer <callback_token>. Тіло:{contract_version:"2.0",request_id,action,result}, де result — повна відповідь виконаної дії. - У разі помилки надішліть
result:{posted:false,message:"reason",status:409}із відповідним кодом 4xx/5xx. Не підтверджуйте успіх, якщо статтю збережено лише частково. - Callback діє одну годину й прив’язаний до запиту, дії та налаштувань. Однакові повтори приймаються; змінений результат повертає 409, неправильний токен — 401, прострочений запит — 410. Система може повторити запит до п’яти разів з інтервалом щонайменше дві хвилини. Усуньте дублювання за request_id та operation_id.
- Тест підключення чекає 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-поля, зміст і час читання. Тестова стаття залишиться на сайті.
Що ви отримуєте після підключення 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 працює сам.