POST /api/v1/admin/stream/ticket

管理面签发一次性建流票据。body `scope` 仅为**收窄声明**,授权上限恒由入口网关注入的受信主体(X-Auth-User-Id / X-Auth-Tenant-Id / X-Auth-Role)派生;非平台租户请求 `platform` 一律 403;跨租户 / 请求 `*` ⇒ 403(STRM-E-008)。浏览器 EventSource 无法携带 Authorization,故必须「先 POST 换票 → 再建流」。

实时流 `bearerAuth` application/json

请求体

接受空 JSON 对象 {}

响应

状态描述Schema
200一次性票据 + 有效期秒数handler.StreamTicketResponse
400请求体非法(stream_ticket_invalid_request)object
401受信主体缺失(stream_ticket_unauthenticated)object
403越权 scope(STRM-E-008)object
503票据存储不可用(stream_ticket_store_unavailable)object

引用的 Schema

handler.StreamTicketResponse

字段类型必填示例约束描述
expires_in integer 否 ExpiresIn 有效期秒数。
ticket string 否 Ticket 一次性句柄(32B crypto/rand → base64 RawURL;不可预测)。