抖音开放平台Logo
控制台

名词解释

更新时间 2024-07-24 02:58:49
收藏
我的收藏

使用开放平台提供的 OpenAPI,开发者可以方便的将抖音生活服务的功能集成进自己的生活服务应用或小程序中

access_token

接口调用凭证。

Beta

接口带了 Beta 标记,表明该接口还在小范围测试中,接口可能会有修改,甚至取消,如果想尝试,欢迎联系我们。

ClientKey

应用的身份标识,全局唯一的一个字符串。

ClientSecret

应用的私钥,一般配合应用的 ClientKey 一起成对使用,用来验证应用的合法性。

对象 ID

对象 ID 表示抖音上各种对象的唯一标识, 如视频 ID、评论 ID、用户 ID。同一对象在不同 app 间的 ID 是不同的。

注意:对象 ID 是有特殊字符的字符串, 作为 URL 参数时, 必须 UrlEncode。

分页

抖音采用 cursor 的方式来分页,第一页请求 cursor 是 0,response 中会返回下一页请求用到的 cursor,同时 response 还会返回 has_more 来表明是否有更多的数据。

说明:不要自己传 cursor=1 这样的的值,要么是 0,要么用请求中返回的下一页 cursor。

流量限制

开放平台基于 Scope 维度做流量限制,可以在"管理中心"中的应用详情中查看具体配额。

OAuth 2.0

OpenAPI 基于OAuth 2.0协议标准。采用的授权码(authorization code)方式,首先需要获取一个临时票据,再用该临时票据获取令牌(access_token)),然后通过该令牌调用 OpenAPI。

OpenAPI 域名

所有 API 都以https://open.douyin.com 开头,如获取用户信息 API 是 https://open.douyin.com/oauth/userinfo/

open_id

授权用户在当前应用的唯一标识。

权限 Scope

当用户通过扫码功能登录您的应用时,您便可访问此用户保存在抖音上的数据子集。权限是向用户询问您是否可以访问这些数据的方式。您所能访问的数据由用户的隐私设置和您请求的权限共同决定。

refresh_token

刷新令牌,用来刷新 access_token。

Scope

用户授权的作用域。

授权

开发者所开发的应用,想要获取用户对应权限,则必须经过用户同意,由应用发起的用户是否同意访问的操作称之为授权。

授权码 Code/Auth Code

授权码,临时调用凭证,即临时票据。

token

调用令牌,接口调用令牌。

推送 Webhooks

当有新的关注事件(Event)发生时,开放平台会通过 https post 的方式将事件推送到开发者事先配置好的回调地址。通过 WebHook 机制可以方便开发者第一时间获取到关注的事件变化,减少轮询调用带来的流量和 Quota 的消耗。

unionid

用户统一标识。用户在当前开发者帐号下的唯一标识(未绑定开发者帐号没有该字段)。

应用

表示开发者在开放平台上申请的应用,每个应用都有一个唯一的 ClientKey,开放平台使用 ClientKey 来识别应用。此外每个应用还有自己的密码, 即 ClientSecret。

注意:一定要保存好 ClientSecret,如果泄露,请立即重置。