创建用户

POST 
/v1/users

为项目创建一个终端用户，并返回它的 id。请把这个 id 和你自己的用户记录存在一起：每次调用都会创建一个新用户。传 issue_token: true 可在同一个响应里拿到该用户的第一个令牌。

请求

响应

201

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。
• invalid_secret — API 密钥无效。

403

调用方已通过鉴权，但无权执行此操作。

• permission_denied — 你没有权限执行此操作。
• project_disabled — 此项目未启用。

404

请求的资源不存在，或对调用方不可见。

• project_not_found — 找不到请求的项目。

413

请求体超过了允许的上限。

• payload_too_large — 请求体太大。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。