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

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

exchangeSession

Обновлено

POST /api/v1/sessions/exchange

exchangeSession

Авторизация и права

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[]

Параметры запроса

ПолеЗначение
0.description"Required for a nonempty POST body by the canonical24-hour HTTP response receipt."
0.in"header"
0.name"Idempotency-Key"
0.requiredtrue
0.schema0.schema

Тело запроса

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

Ответы

ПолеЗначение
201.content.application/json.schemaExchangeResponse
201.description"Exchange approval code for JWT pair"

Ошибки

ПолеЗначение
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid, expired or revoked authentication"
403.content.application/problem+json.schemaProblemDetails
403.description"Required scope, plan or resource policy refused the caller"

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

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