文档中心

数据智能体 DataAgent（私有化）

请输入

企业知识引擎

创建临时 Token

临时 Token 用于同一个应用 Token 下，不同最终用户以不同身份调用 OpenAPI 的场景。创建临时 Token 时只校验应用 Token 是否存在，不校验绑定用户是否有项目或资源权限；实际权限由后续业务 OpenAPI 在使用阶段按绑定用户校验。

接口定义

字段	说明
Method	POST
Path	`/marketing_agent/api/v2/open_application/user_application/temporary_token/create`
Content-Type	`application/json`
认证方式	`Authorization: Bearer <应用 Token>`

Header	必填	说明
Authorization	是	固定应用 Token，格式为 `Bearer <app_token>`。这里的 `app_token` 即应用返回的 AK。

说明

创建临时 Token 不需要传 X-Org/X-Tenant，也不需要传 api_paths/tenant_id。这些能力边界来自应用 Token 本身。

请求体

字段	类型	必填	说明
user	string	是	临时 Token 绑定的最终用户账号。后续使用临时 Token 调用 OpenAPI 时，系统会把该账号作为 `X-User` 传给下游接口。
expire_minutes	integer	否	临时 Token 有效期，单位分钟。不传默认 7 天，即 `10080` 分钟；最大 1 年，即 `525600` 分钟；必须大于 0。

cURL 示例

curl --location 'https://your-domain/marketing_agent/api/v2/open_application/user_application/temporary_token/create' \\
  --header 'Authorization: Bearer <APP_TOKEN_AK>' \\
  --header 'Content-Type: application/json' \\
  --data '{
    \"user\": \"user@example.com\",
    \"expire_minutes\": 10080
  }'

成功响应

接口返回开放平台统一响应结构：code/msg/message/data。成功时 code = 0。

字段	类型	说明
data.token	string	生成的临时 Token 明文。该值只在本次响应中展示一次，服务端落库只保存 hash。
data.notice	string	固定提示：`该token仅明文展示一次，请妥善保存`。
data.expires_at	integer	临时 Token 过期时间，Unix 秒级时间戳。
data.account	string	临时 Token 绑定的最终用户账号，对应请求体里的 `user`。
data.user_application_id	integer	应用 Token 对应的应用记录 ID，仅用于定位应用。
data.org_id	integer	应用 Token 所属组织 ID。

{
  \"code\": 0,
  \"msg\": \"success\",
  \"message\": \"success\",
  \"data\": {
    \"token\": \"tmp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",
    \"notice\": \"该token仅明文展示一次，请妥善保存\",
    \"expires_at\": 1780157073,
    \"account\": \"user@example.com\",
    \"user_application_id\": 123,
    \"org_id\": 1
  }
}

使用临时 Token 调用 API

临时 Token 创建成功后，调用业务 OpenAPI 的方式可参见步骤二：使用 Token 调用 API，即使用 Authorization: Bearer <token>，并继续传 X-Org 和 X-Tenant。系统会先识别临时 Token，反查其关联的应用 Token，复用应用 Token 的项目与接口权限校验，同时把临时 Token 绑定的用户账号作为 X-User 传给下游接口。

常见错误

错误信息	原因	解决方案
`Authorization missing`	未提供 Authorization Header	创建临时 Token 时添加应用 Token Header。
`Need bearer auth`	Authorization 格式错误	使用 `Bearer <app_token>` 格式。
`invalid app token`	应用 Token 不存在	检查应用 Token 是否正确。
`user account is missing`	user 为空	在请求体里传入要绑定的用户账号。
`expire_minutes must be positive`	有效期小于等于 0	传入大于 0 的分钟数。
`expire_minutes must be <= 525600`	有效期超过 1 年	将有效期控制在 525600 分钟以内。

关键约束

创建临时 Token 时不校验绑定用户是否有项目或资源权限；实际权限由下游接口在使用阶段按绑定用户校验。
响应里不返回 token_type。返回的 token 是原始凭证，调用方按开放平台约定放入 Authorization: Bearer <token> 即可。
临时 Token 明文只展示一次，服务端只保存 hash；调用方需要自行妥善保存。
临时 Token 状态目前包括：1=ACTIVE 可用，2=REVOKED 已吊销；过期由 expires_at 判断。

最近更新时间：2026.07.27 21:58:48

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

cURL 示例 #

成功响应 #

cURL 示例

成功响应