抖音开放平台Logo
控制台

OpenAPI 简介
收藏
我的收藏

抖音小程序、小游戏给开发者提供了服务端使用的 HTTPS API 接口。​

​access_token​

access_token 是开发者调用服务端 API 的唯一凭证，开发者应该使用服务端 API 获取 access_token，并使用 access_token 调用其它服务端 API。​
其中，access_token 最多2 小时即过期，重复获取 access_token 会导致上次 access_token 失效。为了平滑过渡，新老 access_token 在 5 分钟内都可使用。​

​请求参数格式说明​

对于文档中提供的 GET 请求，无特殊要求。​
对于文档中提供的 POST 请求，body 中的参数应以 JSON 字符串形式写入。​
当以 JSON 传递数据时候, 需要设置请求头 "content-type": "application/json"。​

​沙盒能力介绍​

抖音沙盒测试环境是抖音开放平台为第三方开发者提供的官方沙盒环境。开发者可以在该沙盒环境中创建沙盒应用，配合开发者的测试服务端和抖音沙盒环境服务端进行测试。但沙盒中创建的应用只能给开发者小范围测试使用，无法面向普通抖音用户进行发布和分发。​
特别的，抖音沙盒环境为开发者提供了一套服务端 OpenAPI 能力，以供开发者调试使用。使用场景、操作步骤均与线上环境相同，所以参考线上文档即可。在抖音沙盒环境中使用时，仅需更换域名即可。​
注意：目前，在抖音沙盒测试环境中存在的服务端 OpenAPI 能力，线上也均存在与之一一对应的能力；但并不是所有线上的能力，都支持抖音沙盒测试环境（是否支持请参考具体文档中是否存在沙盒 URL）。​
沙盒环境的域名为 https://open-sandbox.douyin.com，开发者如需使用沙盒环境，将线上接口的域名更换为沙盒环境域名即可。​
下面以登录接口（https://developer.toutiao.com/api/apps/v2/jscode2session）为例：将请求中的线上环境域名https://developer.toutiao.com替换为沙盒环境域名https://open-sandbox.douyin.com，即可使用抖音沙盒测试环境中的登录接口。​
沙盒环境中，课程库的部分 OpenAPI 能力需要在请求头字段中添加额外信息，如需使用请详细阅读课程库接口。​