Документация / Как начать / Работа с MCP / Идентификаторы и страницы результатов / REST: onboarding / registerMiniAppOrigin Для AI-агентов: markdown этой страницы — /docs/api-op-registerminiapporigin.md · индекс документации — /llms.txt
registerMiniAppOrigin Обновлено 10 октября 2026 г.
POST /api/v1/tools/onboarding/mini-app-origin
registerMiniAppOrigin
# Авторизация и праваScopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
Поле Значение security.0.hubApiKey [] security.1.hubBearer [] securitySchemes.hubApiKey.in "header" securitySchemes.hubApiKey.name "X-Api-Key" securitySchemes.hubApiKey.type "apiKey" securitySchemes.hubBearer.scheme "bearer" securitySchemes.hubBearer.type "http" x-required-scopes ["onboarding:write"]
# Параметры запросаПоле Значение 0.description "Required for the nonempty canonical Mini App registration request." 0.in "header" 0.name "Idempotency-Key" 0.required true 0.schema 0.schema
# Тело запроса# ОтветыПоле Значение 201.content.application/json.schema MiniAppOriginRegistration 201.description "The tenant host is recorded as the channel's Mini App origin in status pending, with the recipe the owner follows: the BotFather Mini App URL for Telegram, the business.max.ru Mini App URL for MAX (moderated), nothing to paste for VK. The origin becomes registered on the first validly signed launch from it. No messenger API is called (ADR-331 D4)."
# ОшибкиПоле Значение 400.content.application/problem+json.schema ProblemDetails 400.description "Request body failed validation — a non-HTTPS origin, an origin other than the zone's tenant host, an unknown zone, or a smuggled tenant id." 401.content.application/problem+json.schema ProblemDetails 401.description "Missing, invalid, revoked, or expired Hub credential." 403.content.application/problem+json.schema ProblemDetails 403.description "The authenticated credential lacks the onboarding:write scope." 422.content.application/problem+json.schema ProblemDetails 422.description "INVALID_INPUT: the channel has no Mini App in this zone (MAX and VK accept only ru)."
# Дополнительные условияПоле Значение operationId "registerMiniAppOrigin" tags ["onboarding"] x-idempotency "http-cache"