Подключить клиента, проект, баланс и integration key

1. Пользователь

POST /users
{"external_user_id": "constructor-user-123", "email": "client@example.com",
 "name": "Иван Петров", "marketing_opt_in": false, "referral_code": "ABC123"}

• Создаёт аккаунт или возвращает уже связанный с вами: "created": true/false.
• Новому пользователю начисляются бонусные токены по обычным правилам регистрации — один раз (bonus_tokens_granted).
• referral_code применяется только при создании. Неверный код — 400 invalid_referral_code.
• Если почта уже занята аккаунтом, не связанным с вами, — 409 already_exists.

GET /users/{user_id} возвращает данные пользователя.

2. Проект

POST /projects
{"external_project_id": "site-456", "user_id": 1024, "name": "Сайт компании",
 "domain": "https://example.com", "description": "…", "tone_of_voice": "…",
 "target_audience": "…", "restrictions": "…", "language": "ru", "region": "225",
 "daily_article_limit": 1}

• Обязательны external_project_id, user_id, name, domain. Остальные поля — контекст бизнеса и настройки, как в панели — Бизнес, аудитория, тон, запреты и заполнение по сайту.
• GET /projects/{project_id} — данные проекта.
• PATCH /projects/{project_id} — изменить описание, тон, аудиторию, запреты, дневной лимит.

3. Ключ интеграции

• POST /users/{user_id}/integration-key — выпускает ключ External API пользователя или возвращает существующий.
• POST /users/{user_id}/integration-key/rotate — перевыпуск: старый ключ сразу перестаёт работать.

Ключ интеграции — тот же ключ аккаунта, что создаётся в панели, — X-Api-Key, Project ID, права и безопасная ротация ключа аккаунта.

4. Баланс

GET /users/{user_id}/balance
→ {"ok": true, "balance": {"user_id": 1024, "tokens": 8500, "estimated_articles": 4}}

estimated_articles — ориентир по средней стоимости статьи. Пополнение баланса пользователь делает в SerpJet — Пополнить картой: пакет, своя сумма и продолжение существующей оплаты.