# Agent API: регистрация и оплата из ИИ-агента

ИИ-агент может сам завести аккаунт для своего человека, сразу получить код виджета, а потом — ссылку на оплату, которую оплачивает человек. База: `https://monochat.ru/api/agent/v1`. JSON, CORS открыт.

## 1. Регистрация

```bash
curl -X POST https://monochat.ru/api/agent/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@company.ru","site_domain":"company.ru","agent":"cursor"}'
```

Ответ `201`: `widget_key`, `install` (готовые сниппеты html/react/nextjs/vue/tilda/npm), `agent_key` (`mc_agent_…`, показывается один раз), `status: "pending_confirmation"`, `tell_the_human`.

Владельцу уходит письмо для подтверждения. Подтвердить можно и входом на monochat.ru/login через Google/Яндекс с тем же email.

До подтверждения: виджет работает сразу (тариф «Старт»), `agent_key` действует только на `/api/agent/v1/*`, не больше 3 доменов. После подтверждения `GET /status` один раз выдаёт полный REST-токен `mc_live_…`.

Ошибки: `400 invalid_email|invalid_domain`, `409 account_exists` (попросите человека войти и взять код в кабинете), `429 rate_limited`.
Защита от спама: лимиты по IP (3/час, 10/сутки), одноразовые email запрещены, один аккаунт на email.

## 2. Статус и полный API-токен

```bash
curl https://monochat.ru/api/agent/v1/status -H "Authorization: Bearer $MONOCHAT_AGENT_KEY"
```

`confirmed`, `plan`, `widget_key`, `allowed_domains`, `install`; после подтверждения — одноразово `api_token`.

## 3. Добавить домен (превью, стейджинг)

```bash
curl -X POST https://monochat.ru/api/agent/v1/widget/domains \
  -H "Authorization: Bearer $MONOCHAT_AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"my-app.vercel.app"}'
```

## 4. Тарифы и ссылка на оплату

```bash
curl https://monochat.ru/api/agent/v1/plans
curl -X POST https://monochat.ru/api/agent/v1/payment-link \
  -H "Authorization: Bearer $MONOCHAT_AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"plan":"business","period":"month"}'
```

`plan`: `business` (1 990 ₽/мес), `pro` (4 990 ₽/мес), `team` (9 990 ₽/мес); `period`: `month` или `year` (1 390 / 3 490 / 6 990 ₽/мес при оплате за год). Возвращает `payment_url` (Robokassa), который нужно отдать человеку. Платёж разовый, автосписаний нет. Тариф включается сразу после оплаты.

## 5. Повторное письмо

`POST /api/agent/v1/resend-confirmation` — до 3 раз в сутки.