错误处理

所有错误均包含稳定的机器可读 code。调用方应依据 HTTP 状态和 code 分支处理，不要解析中文或英文提示文本。

HTTP	Code	处理建议
400	INVALID_REQUEST	修正路径、查询、请求头或请求体
401	AUTHENTICATION_FAILED	检查 AK、签名和客户端状态
401	REQUEST_EXPIRED	校准时钟并使用新时间戳重签
401	REQUEST_REPLAYED	使用新的随机 Nonce 重签
403	CAPABILITY_DENIED	联系管理员授权并发布能力
404	RESOURCE_NOT_FOUND	检查资源标识和数据范围
409	CONFLICT	检查资源状态或幂等键冲突
429	RATE_LIMITED	按 Retry-After 延迟重试
429	QUOTA_EXCEEDED	释放观看连接后按 Retry-After 重试
503	SERVICE_UNAVAILABLE	短暂退避，记录请求 ID 后重试

每次请求都会返回请求 ID。问题排查时应同时提供请求 ID、调用时间、路径和 HTTP 状态，禁止提交 SK 或完整签名原文。