获取调用凭证 Token
Token 是一种用于身份验证和授权的加密字符串,本质是服务端颁发的数字凭证,用于验证请求合法性并控制资源访问权限。其核心价值包括:
- •无状态化验证:服务端无需存储用户会话,通过 Token 即可验证身份。
- •权限精细化控制:通过 Token 携带的
scope
字段限制接口调用范围。- •安全隔离:避免直接传输用户名 / 密码等敏感信息,降低数据泄露风险。
在抖音开放平台,Token 是调用 API 的必需凭证,根据业务场景分为用户级、企业级、应用级 3 类。
Token 类型及区别
token 类型 | 定义 | 使用场景 | 有效期 | 是否需要用户授权 |
client_token | 由抖音开放平台颁发的应用级凭证,用于验证小程序身份,访问无需用户授权的公共接口。 | 获取小程序基础信息、管理消息模板等无需用户身份的操作。 | 2 小时 到期前需通过相同流程重新获取。 | ❌ 否 |
access_token | 由用户授权生成的用户级凭证,用于访问需要用户权限的接口(如用户数据、操作执行)。 | 获取用户 openid、发送客服消息等需用户授权的操作。 | 15 天 到期前需通过 refresh_token 续期(refresh_token 有效期 30 天)。 | ✅ 是 |
biz_token | 由抖音开放平台颁发的企业级凭证,用于验证企业资质,调用需企业权限的敏感接口。 | 管理企业订单、处理私域用户消息等经营能力接口。 | 30 天 需定期审核企业资质(如营业执照、法人信息)。 | ✅ 是(企业授权) |
获取 client_token
前提条件
- 1.已在抖音开放平台注册并创建小程序。
- 2.在控制台的开发 -> 开发配置页面中获取 AppID(
client_key
)和 AppSecret(client_secret
)。获取流程
说明
- •安全存储:
- ◦
AppSecret
和 client_token
属于敏感信息,必须存储在服务端,禁止前端直接使用。- ◦建议使用加密存储(如 Redis + AES 加密)。
- •有效期管理:
- ◦
client_token
有效期通常为 2 小时,需设置定时任务刷新。- ◦可通过 Redis 的
EXPIRE
命令自动管理过期时间。获取 access_token
前提条件
- 1.已在抖音开放平台注册并创建小程序。
- 2.在控制台的开发 -> 开发配置页面中获取 AppID(
client_key
)和 AppSecret(client_secret
)。获取流程
说明
- •安全存储:
- ◦
AppSecret
、access_token
和 refresh_token
属于敏感信息,必须加密存储在服务端。- ◦建议使用 Redis 或数据库存储,关联用户
open_id
。- •有效期管理:
- ◦
access_token
有效期通常为 2 小时,需在调用前检查有效性。- ◦
refresh_token
有效期为 30 天,过期后需重新获取用户授权。- 1.前端调用 tt.login 获取用户授权
code
。- 2.服务端通过
code
、app_id
、app_secret
,调用获取用户授权调用凭证换取 access_token
和 refresh_token
。- 3.
access_token
过期后调用刷新用户授权调用凭证重新获取新的 access_token
。
获取 BusinessToken
前提条件
- 1.企业资质认证需满足以下条件:
- a.在抖音开放平台完成企业主体认证。
- b.提交营业执照、法人信息等资料。
- 2.应用类型需满足以下要求:
- ◦应用类型必须为 「企业应用」 或 「商家应用」。
- ◦需在开放平台申请企业相关权限。
- 3.在控制台的开发 -> 开发配置页面中获取 AppID(
client_key
)和 AppSecret(client_secret
)。获取流程
说明
- •安全存储:
- ◦
AppSecret
和 biz_token
属于敏感信息,必须存储在服务端,禁止前端直接使用。- ◦建议使用加密存储(如 Redis + AES 加密)。
- •有效期管理:
- ◦
biz_token
有效期通常为 30 天,需设置定时任务刷新。- ◦可通过 Redis 的
EXPIRE
命令自动管理过期时间。- •权限范围:
- ◦返回的
scope
字段表示当前应用被授权的企业接口范围。- ◦如需更多权限,需在开放平台提交权限申请。
- 1.前端调用 tt.login 获取用户授权
code
。- 2.服务端通过
code
、app_id
、app_secret
,调用 code2Session 获取 openid
。- 3.服务端通过 openid、
app_id
、app_secret
,调用 BusinessToken 生成获取 biz_token
及有效期。- 4.
biz_token
过期后调用 BusinessToken 刷新重新获取新的 biz_token
。