启用或停用用户
PATCH/v1/users/:user_id
停用或重新启用一个终端用户。停用会作废该用户持有的全部令牌,停用期间也无法签发新令牌;重新启用后,请为该用户签发新令牌。
请求
响应
- 200
- 401
- 403
- 404
- 413
- 422
- 429
- 500
成功响应
鉴权失败:凭证缺失、格式错误、已过期或已作废。
invalid_token— 访问令牌无效。project_disabled— 此项目未启用。token_expired— 访问令牌已过期。user_disabled— 此用户未启用。invalid_secret— API 密钥无效。
调用方已通过鉴权,但无权执行此操作。
permission_denied— 你没有权限执行此操作。project_disabled— 此项目未启用。
请求的资源不存在,或对调用方不可见。
project_not_found— 找不到请求的项目。user_not_found— 找不到请求的用户。
请求体超过了允许的上限。
payload_too_large— 请求体太大。
请求中的某个值未通过校验;details 数组会列出每个出错的字段。
validation_failed— 请求内容未通过校验。
要么是请求太多(Retry-After 响应头会说明何时重试),要么是计费账户的积分已用完(不带 Retry-After——加上积分才能继续);用 code 字段区分这两种情况。
rate_limited— 请求太频繁,请放慢速度。
服务端发生了意外错误。
internal— 发生了意外错误。