签发用户令牌

POST 
/v1/users/:user_id/tokens

为项目的某个终端用户签发 Bearer 令牌。由你的后端调用，并把令牌交给该用户的应用，应用再用它调用终端用户的接口（会话、消息、文件、语音）。expires_in 设置令牌的有效期（60–86400 秒，默认 3600）。不能为已停用的用户签发令牌。签发新令牌不影响该用户之前的令牌；要让它们失效，请作废它们。

请求

响应

201

成功响应

401

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

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

403

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

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

404

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

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

413

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

• payload_too_large — 请求体太大。

422

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

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

429

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

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

500

服务端发生了意外错误。

• internal — 发生了意外错误。