云调用
收藏
我的收藏介绍
云调用是具有「免鉴权 + 内网专线 调用抖音开放服务接口」特性的能力,抖音云生态的一部分。
免鉴权:在云调用出现之前,开发者如需使用抖音开放服务 OpenAPI 提供了一系列开放能力,这些接口的调用均需要维持三方授权(
getAccessToken
)后获取的 access_token,并自己维护 token 的有效期和安全。而获取 access_token,涉及到密钥交互请求,容易暴露密钥导致被盗用,对开发者和抖音服务都有消极的影响。云调用则致力于解决这类问题,借助抖音云托管与抖音小程序的生态闭环性,将开放能力的调用免鉴权化,抛弃传统 token 方式,简化开发者的开发负责度,提升开发体验。内网专线:抖音云为托管在云上的开发者服务,提供一条访问抖音开放能力服务的内网专线。比公网请求更稳定,更高效。
使用方法
云调用与自研模式区别
云调用在使用上与自研模式基本一致,主要区别:
- 1.在抖音云上部署的服务中调用 OpenAPI 。
- a.不再需要在请求参数或者 header 中添加 access_token ,将自动实现免鉴权的能力。
- b.访问OpenAPI的域名需要把抖音开放平台的域名替换为云调用域名
抖音开放平台 OpenAPI 域名 | 对应的云调用域名 |
| |
- 2.云调用使用需要将HTTPS协议改为HTTP协议,云调用目前只支持 HTTP 协议
举例说明
以 OpenAPI 接口的文字检测接口为例,如果需要正常请求 OpenAPI 需要在请求 header 的 X-Token 字段添加 access_token。OpenAPI 都是 HTTP 形式提供,下面以 curl 请求 OpenAPI 接口,开发者可以根据自己所使用的语言进行调整。
- •自研模式:
curl -X POST -H "Content-type: application/json" \ -H "X-Token: ${access_token}" \ -d '{"tasks": [{"content": "要检测的文本"}]}' \ https://developer.toutiao.com/api/v2/tags/text/antidirt
- •云调用模式:
curl -X POST -H "Content-type: application/json" \ -d '{"tasks": [{"content": "要检测的文本"}]}' \ http://developer-toutiao-com.openapi.dyc.ivolces.com/api/v2/tags/text/antidirt