Partner API — техническая документация

Обмен статьями с «Лисиндером» идёт по простому JSON API, без скрайпинга сайтов друг друга. Ключ и список рубрик для каждой стороны выдаёт наш администратор при подключении партнёрства (см. страницу партнёрства).

Аутентификация

Единственное, что вам нужно для доступа к нашим материалам — это partnerKey, выдаваемый лично вашей редакции при подтверждении партнёрства в нашей админке. Без него запрос не вернёт ничего, независимо от прочих полей. Никакие другие технические ключи публично не раскрываются — все нужные значения для интеграции вы получите напрямую от нас при подключении.

Если вы получаете наши материалы

Отправьте POST-запрос на наш эндпоинт с вашим ключом (точный адрес эндпоинта также сообщается при подключении):

POST <адрес эндпоинта, сообщается при подключении>
Content-Type: application/json

{
  "partnerKey": "<ваш ключ, выдан лично вам>",
  "categoryId": "politics",
  "since": "2026-07-01T00:00:00Z"
}

categoryId необязателен (без него — все разрешённые вам рубрики). since необязателен (без него — с начала архива).

Если мы получаем ваши материалы

Ваша сторона должна предоставить нам URL похожего эндпоинта (your_feed_url, сообщите его нашему администратору) и свой ключ для нас (your_api_key) — мы будем вызывать его по расписанию. Запрос от нас к вам будет выглядеть так же просто, без обёртки plugins:call — это внутренняя деталь нашей платформы:

POST <your_feed_url>
Content-Type: application/json

{
  "partnerKey": "<ключ, который вы нам выдали>",
  "categoryId": "tech",
  "since": "2026-07-01T00:00:00Z"
}

Формат ответа (в обе стороны одинаковый)

{
  "ok": true,
  "articles": [{
    "sourceUrl": "https://partner-site.com/article-slug",
    "title": "...",
    "excerpt": "...",
    "authorName": "...",
    "categoryId": "politics",
    "language": "ru",
    "publishedAt": "2026-07-13T10:00:00Z",
    "imageUrl": "https://.../image.jpg",
    "imageAlt": "...",
    "blocks": [
      {"type": "paragraph", "runs": [{"text": "..."}]},
      {"type": "heading", "level": 2, "text": "..."},
      {"type": "quote", "runs": [{"text": "..."}]},
      {"type": "list", "items": ["...", "..."]}
    ]
  }],
  "nextSince": "2026-07-13T10:00:00Z"
}

blocks — простая структура абзацев/заголовков/цитат/списков, без HTML и без разметки. nextSince присутствует, если в архиве остались ещё материалы — продолжайте запрашивать, подставляя его как новый since, пока поле не перестанет приходить. Так можно получить весь архив по вашим рубрикам целиком, без ограничения на количество — постранично.

Публикация у нас

Полученные от партнёра материалы публикуются у нас без изменений — со ссылкой на первоисточник и указанием автора. Мы не переписываем и не редактируем присланные тексты.