错误契约
错误码 Problem types
v2 的每个错误体都带一个 type URI,它解析到这里的某一页。下面是中文说明;每页同时保留英文原文, code 这类线上标识一律不翻译。字段级的 errors[].reason 是另一套词表,与这里的 code 互不重叠——两层怎么分支见 错误处理 。
平台通用 platform · 27
- 400MALFORMED_BODY请求体格式错误
- 400INVALID_PARAMETER参数不合法
- 400UNKNOWN_ENUM_VALUE未知的枚举值
- 400MUTUALLY_EXCLUSIVE_PARAMETERS参数互斥
- 400LIMIT_TOO_LARGElimit 超出上限
- 400TOO_MANY_IDSid 数量过多
- 400INVALID_CURSOR游标不合法
- 400UNKNOWN_INCLUDE未知的 include token
- 400UNKNOWN_FIELD未知的字段名
- 400UNKNOWN_SORT未知的排序键
- 400UNKNOWN_FACET未知的 facet 名
- 401MISSING_CREDENTIAL缺少凭据
- 401INVALID_CREDENTIAL凭据无效
- 403SCOPE_REQUIRED缺少所需 scope
- 403FIRST_PARTY_ONLY仅限一方客户端
- 404NOT_FOUND未找到
- 405METHOD_NOT_ALLOWED方法不被允许
- 409IDEMPOTENCY_KEY_REUSED幂等键被复用
- 410GONE已永久退役
- 412PRECONDITION_FAILED前置条件不满足
- 415UNSUPPORTED_MEDIA_TYPE不支持的媒体类型
- 422VALIDATION_FAILED校验失败
- 428PRECONDITION_REQUIRED缺少前置条件
- 429RATE_LIMITED触发速率限制
- 429QUOTA_EXCEEDED配额耗尽
- 500INTERNAL_ERROR服务端内部错误
- 503SERVICE_UNAVAILABLE服务暂不可用