POST /api/v1/stream/ticket

受信主体签发一次性建流票据:授权 scope **强制** `user:<受信主体>`,与请求体无关;请求体携带非 self 的 scope ⇒ 403。缺失受信头(入口网关未注入)⇒ 401(fail-closed,绝不匿名放行)。

实时流 `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;不可预测)。