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

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

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

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-токен

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

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

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

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. Тарифы и ссылка на оплату

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 раз в сутки.