参考
错误和速率限制
REST 错误使用此信封。保留请求 ID 以获取支持，并且切勿记录您的 API 密钥： { "error": { "code", "message", "requestId" } }
| 代码 | HTTP | 含义 |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 表示请求正文无效；HTTP 409 表示上传在当前状态下无法完成。 |
| UNAUTHORIZED | 401 | API 密钥丢失、无效或已撤销。 |
| PAID_PLAN_REQUIRED | 403 | 该帐户没有符合条件的付费计划。 |
| INSUFFICIENT_SCOPE | 403 | API 密钥不包含所需的权限范围。 |
| NOT_FOUND | 404 | 找不到拥有的上传、文件或共享。 |
| UPLOAD_NOT_READY | 409 | 上传的对象尚未准备好完成。 |
| FILE_TOO_LARGE | 413 | 文件超出了适用的大小限制。 |
| OBJECT_VALIDATION_FAILED | 422 | 上传的对象验证失败。 |
| QUOTA_EXCEEDED | 429 | 上传配额已用完。 |
| RATE_LIMIT_EXCEEDED | 429 | 已超出 API 请求频率限制。 |
| SERVICE_UNAVAILABLE | 503 | 所需的服务暂时不可用。 |
速率限制标头
仅在 429 响应中返回速率限制标头： X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After.