/api/v1/stream/ticket
受信主体签发一次性建流票据:授权 scope **强制** `user:<受信主体>`,与请求体无关;请求体携带非 self 的 scope ⇒ 403。缺失受信头(入口网关未注入)⇒ 401(fail-closed,绝不匿名放行)。
请求体
接受空 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;不可预测)。 |