К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/onboarding/submit

Проверить полноту анкеты и отправить на разбор.

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/onboarding/submit
ДоступCookie кабинета · Mini App (TMA)
Scope для ключейключи не принимаются – только кабинет (403 CREDENTIAL_NOT_ALLOWED)
operationIdonboardingSubmit

Описание#

Проверить полноту анкеты и отправить на разбор: обязательны role, business, scenario, level, aiTools, budget, tools, time, hardware, os, goal, about; при «Другое» также scenarioOther / aiToolsOther / toolsOther. Socials, website и setup необязательны. Затем состояние in_review, уведомление в outbox. Повторная отправка готового состояния идемпотентна. Не хватает полей – ONBOARDING_INCOMPLETE с issues.

Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.

Path: параметров нет.

Query: нет объявленных полей.

Body: не требуется.

Ответ · статус и структура

Ответ: 200 application/json, Onboarding.

Краткая форма: { schemaVersion: 2, status: OnboardingStatus, step: integer, answers: OnboardingDraft, completedAt: string | null }.

Пример JSON; значения демонстрационные.

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 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 403 ORIGIN_REJECTED, 422 VALIDATION_FAILED, 422 ONBOARDING_INCOMPLETE, 403 CREDENTIAL_NOT_ALLOWED; общие ошибки.

Лимиты: Отдельного throttle в коде нет.

bash
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'

Ответы по контракту#

СтатусТипСхемаОписание
200application/jsonOnboardingУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, ONBOARDING_INCOMPLETE

Машиночитаемый контракт: openapi.json, операция onboardingSubmit.