REST API
POST/ api/ v1/ onboarding/ submit
Проверить полноту анкеты и отправить на разбор.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | onboardingSubmit |
Описание#
Проверить полноту анкеты и отправить на разбор: обязательны role, business, scenario, level, aiTools, budget, tools, time, hardware, os, goal, about; при «Другое» также scenarioOther / aiToolsOther / toolsOther. Socials, website и setup необязательны. Затем состояние in_, уведомление в outbox. Повторная отправка готового состояния идемпотентна. Не хватает полей – ONBOARDING_ с issues.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, Onboarding.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"schemaVersion": 2,
"status": "in_review",
"step": 12,
"answers": {
"role": "Основатель бизнеса",
"business": "Развиваю студию дизайна, в команде 5 человек",
"scenario": [
"Продажи и заявки",
"Документы и отчёты"
],
"level": "Пользуюсь ChatGPT/Claude каждый день",
"aiTools": [
"ChatGPT",
"Claude"
],
"budget": "50_100",
"tools": [
"Telegram",
"Notion",
"Битрикс24",
"Другое"
],
"toolsOther": "Figma",
"time": "3–5 часов в неделю",
"hardware": [
"Платный публичный VPN",
"Нужна помощь с настройкой"
],
"os": "macOS",
"goal": "Хочу агента, который разбирает заявки и готовит сводку по продажам",
"about": "Работаю из Москвы, удобнее учиться по вечерам.",
"socialsPersonal": [
"@studio_founder",
"https://vk.com/studio.founder"
],
"socialsBusiness": [
"https://t.me/studio_design_channel"
],
"website": "https://studio-design.ru",
"setup": "claude"
},
"completedAt": "2026-11-04T10:00:00Z"
}Ошибки: 401 , 403 , 503 , 429 , 403 , 422 , 422 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i -X POST https://aos.edgelab.space/api/v1/onboarding/submit \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
-H 'Origin: https://aos.edgelab.space'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | Onboarding | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, ONBOARDING_INCOMPLETE |
Машиночитаемый контракт: openapi.json, операция onboardingSubmit.