Статьи на вашем сайте

SDK для Node.js

Пакет работает с Next.js, Express и другими серверными приложениями. Адрес API и siteKey храните в настройках окружения сайта.

npm install https://duohuman.ai/polosa/integrations/content-factory-blog-sdk-0.2.1.tgz

import { createCachedBlogClient } from "@content-factory/blog-sdk";
const blog = createCachedBlogClient({
  apiBaseUrl: process.env.POLOSA_BLOG_API_URL,
  siteKey: process.env.POLOSA_BLOG_SITE_KEY,
});
const articles = await blog.listPosts({ locale: "ru", page: 1 });

SDK кеширует публичные ответы на 30 секунд и сохраняет последнюю успешную версию ещё на пять минут при временном сбое API. Предпросмотр не кешируется.

Несколько языков

Выберите языки в подключении сайта. Polosa подготовит версии одной статьи вместе. Читайте нужную версию через параметр locale. Поле translations в ответе статьи содержит адреса опубликованных переводов для переключателя языка и hreflang.

Для сайта с английской версией без префикса используйте общий путь /{locale}/blog/{slug} и отдельный путь для en: /blog/{slug}. Настройка доступна в «Адреса языковых версий».

Если API вернул другой slug, перенаправьте старый адрес на canonicalUrl с кодом 308: Polosa сохраняет прежние адреса после переименования статьи.

Что возвращает статья

{
  "id": "UUID статьи",
  "siteKey": "my-blog",
  "locale": "ru",
  "revision": 1,
  "slug": "pervaya-statya",
  "title": "Название статьи",
  "excerpt": "Краткое описание",
  "bodyMarkdown": "## Заголовок\n\nТекст статьи.",
  "seoTitle": "Название для поиска",
  "seoDescription": "Описание для поиска",
  "canonicalUrl": "https://site.example/blog/pervaya-statya",
  "callToAction": { "label": "Подробнее", "url": null },
  "publishedAt": "2026-10-09T10:00:00.000Z",
  "updatedAt": "2026-10-09T10:00:00.000Z"
}

Если callToAction.url равен null, кнопку со ссылкой выводить не нужно. Обложка приходит в необязательном поле cover с url, alt, width и height. Если cover отсутствует, выводите статью без изображения.

Подпись кнопки приходит в callToAction.label. Кнопка и ссылки внутри Markdown могут вести через наш адрес перехода: выводите полученные href целиком. Не открывайте их заранее на сервере и не отправляйте отдельное событие того же клика.

Формат текста: CommonMark с GFM (таблицы, списки задач, зачёркивание и автоматические ссылки). Отключите исполнение HTML. Смена slug пока не создаёт перенаправление старого адреса; обычное обновление текста сохраняет ID статьи.

Список возвращает items с теми же полями, кроме bodyMarkdown и callToAction, а также siteKey, locale и pagination с полями page, limit, total, totalPages. Статьи отсортированы от новых к старым. Размер страницы: от 1 до 50, по умолчанию 20.

Пустой блог возвращает HTTP 200 и пустой items. Несуществующая статья или подключение возвращают HTTP 404. При HTTP 400 проверьте параметры, при HTTP 500 покажите ошибку загрузки с повтором. Ошибки содержат поле error.

Регистрации и заявки

В «Сайты для конверсий» добавьте адрес сайта, на котором происходит действие, и включите связь с переходами. На этот сайт будет передаваться pl_click, идентификатор конкретного перехода. У существующих параметров ссылки сохраняются значения.

Установите счётчик с тем же siteKey на целевом сайте. После успешного действия вызовите:

window.PolosaAnalytics?.conversion("signup", {
  eventId: crypto.randomUUID()
});

Один eventId относится к одному действию. Для повторной отправки сохраните и используйте тот же ID. Скрипт хранит переход в sessionStorage текущей вкладки, не дольше 30 дней. Другой сайт может отправить конверсию только с подходящим pl_click.

POST /public/v1/sites/YOUR_SITE_KEY/conversions
Authorization: Bearer YOUR_SERVER_KEY
Content-Type: application/json

{
  "type": "conversion",
  "eventId": "70215239-a2e8-4ab2-aee4-9b4e03e89c02",
  "name": "signup",
  "clickId": "6c62904a-c302-4448-99de-56615f201d78"
}

Отчёт отдельно показывает события браузера и сервера. Они не равны числу уникальных покупателей или подтверждённой выручке. История переходов и событий статьи объединяет все её опубликованные версии.