К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/api-op-registerminiapporigin.mdиндекс документации — /llms.txt

registerMiniAppOrigin

Обновлено

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.requiredtrue
0.schema0.schema

Тело запроса

ПолеЗначение
content.application/json.schemacontent.application/json.schema
requiredtrue

Ответы

ПолеЗначение
201.content.application/json.schemaMiniAppOriginRegistration
201.description"Owner-confirmed Mini App origin recorded; no Bot API mutation occurs (ADR-076 / ADR-149)."

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Request body failed validation — a non-HTTPS origin, an unknown zone, or a smuggled tenant id."
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid, revoked, or expired Hub credential."
403.content.application/problem+json.schemaProblemDetails
403.description"The authenticated credential lacks the onboarding:write scope."

Дополнительные условия

ПолеЗначение
operationId"registerMiniAppOrigin"
tags["onboarding"]
x-idempotency"http-cache"