/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 换票 → 再建流」。
请求体
接受空 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;不可预测)。 |