SerpJet API для интеграционных партнёров
Клиенты, проекты, брифы и одноразовый вход.
- Доступ по X-Partner-Key и модель клиентов / проектов Partner API нужен конструкторам сайтов и агентствам, которые создают пользователей и проекты SerpJet из своей системы. Все запросы идут с сервера партнёра с ключом X-Partner-Key; ключ выдаёт команда SerpJet.
- Подключить клиента, проект, баланс и integration key Создайте пользователя (POST /users), проект для его сайта (POST /projects), выпустите ключ интеграции (POST /users/{id}/integration-key) и проверяйте баланс (GET /users/{id}/balance). Повторные вызовы с теми же внешними ID не создают дублей.
- Одноразовый вход: magic link, срок и безопасный redirect POST /users/{id}/magic-link создаёт одноразовую ссылку входа в SerpJet без пароля, действующую не больше 30 минут, с переходом на локальный путь redirect_path.
- Создать бриф и дождаться готовой статьи POST /projects/{id}/manual-briefs ставит тему статьи в генерацию. Затем опрашивайте GET /manual-briefs/{id}, пока статус не станет ready, и заберите статью через GET /articles/{id}.
- External IDs, повторы, конфликты и ошибки external_user_id, external_project_id и external_request_id делают создание идемпотентным: повтор возвращает уже созданный объект. Конфликты — 409 already_exists, ошибки данных — 400 validation_error.
- Связать Partner API генерации с External API доставки Partner API создаёт пользователей, проекты и статьи, а External API доставляет статьи на сайт с подтверждением и обновлениями. Выпустите ключ интеграции через Partner API и используйте его в X-Api-Key для pull и result.