К содержанию
SerpJet Документация Войти
Разделы
  1. Документация
  2. API для интеграционных партнёров

Связать Partner API генерации с External API доставки

Partner API создаёт пользователей, проекты и статьи, а External API доставляет статьи на сайт с подтверждением и обновлениями. Выпустите ключ интеграции через Partner API и используйте его в X-Api-Key для pull и result.

Проверено
Содержание
  1. Кто за что отвечает
  2. Как связать
  3. Почему External API лучше для публикации

Кто за что отвечает

Partner APIExternal API
Адрес/partner/api/v1/external/
КлючX-Partner-Key партнёраX-Api-Key пользователя (ключ интеграции)
ЗадачиПользователи, проекты, баланс, вход, заказ статейДоставка новых статей и обновлений, подтверждение публикации, адреса

Как связать

  1. Получите ключ интеграции пользователя: POST /partner/api/v1/users/{user_id}/integration-key.
  2. Используйте его в External API для проекта пользователя: 
    GET /external/articles/new/pull?project_id=321&limit=20
X-Api-Key: <integration key>
X-SerpJet-Capabilities: stable-article-identity-v1
  3. После публикации на сайте отправьте result с адресом — Быстрый старт своей CMS: pull → upsert → result.
  4. Опрашивайте и /articles/improvements/pull, чтобы обновления статей тоже доходили до сайта — Новые статьи и улучшения: различия жизненного цикла.

Почему External API лучше для публикации

  • SerpJet узнаёт адрес статьи — работают аналитика и автообновление.
  • Новые версии статей приходят автоматически, без отдельного запроса по каждой.
  • Повторы безопасны благодаря delivery_id и article_identity — article_id, delivery_id, article_identity, capability и защита от дублей.

GET /partner/api/v1/articles/{id} подходит для предпросмотра в вашем интерфейсе, но не сообщает SerpJet о публикации.

Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.