SerpJet Доступ по X-Partner-Key и модель клиентов / проектов
Partner API нужен конструкторам сайтов и агентствам, которые создают пользователей и проекты SerpJet из своей системы. Все запросы идут с сервера партнёра с ключом X-Partner-Key; ключ выдаёт команда SerpJet.
Содержание
Что это
Partner API позволяет из вашей системы:
- создавать пользователей SerpJet и проекты для их сайтов;
- получать баланс пользователя;
- выпускать ключ интеграции для External API;
- создавать одноразовую ссылку входа в SerpJet;
- отправлять темы на генерацию и получать готовые статьи.
Это не денежная партнёрская программа и не «Пригласи друга» — Денежная партнёрская программа: условия и заявка.
Доступ
Base URL: https://serpjet.ru/partner/api/v1
X-Partner-Key: <ключ партнёра>
Content-Type: application/json- Ключ партнёра выдаёт команда SerpJet — напишите в поддержку.
- Используйте ключ только на сервере. Не передавайте его в браузер или мобильное приложение.
- Неверный или отсутствующий ключ —
401 invalid_partner_key.
Модель данных
| Ваша система | SerpJet | Связь |
|---|---|---|
| Пользователь | Аккаунт SerpJet (user_id) со своим балансом | external_user_id |
| Сайт | Проект (project_id) | external_project_id |
| Заказ статьи | Ручной бриф → статья | external_request_id |
Партнёр видит только пользователей и проекты, которые создал сам: к чужим объектам — 403 forbidden или 404 not_found.
Общая схема
- Создать пользователя — Подключить клиента, проект, баланс и integration key.
- Создать проект и выпустить ключ интеграции.
- Отправить тему на генерацию — Создать бриф и дождаться готовой статьи.
- Получить статью через Partner API или доставить её через External API — Связать Partner API генерации с External API доставки.
- При необходимости — ссылка входа в SerpJet — Одноразовый вход: magic link, срок и безопасный redirect.
Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.