云调用

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

介绍​

云调用是具有「免鉴权 + 内网专线 调用抖音开放服务接口」特性的能力,抖音云生态的一部分。​
免鉴权:在云调用出现之前,开发者如需使用抖音开放服务 OpenAPI 提供了一系列开放能力,这些接口的调用均需要维持三方授权(getAccessToken)后获取的 access_token,并自己维护 token 的有效期和安全。而获取 access_token,涉及到密钥交互请求,容易暴露密钥导致被盗用,对开发者和抖音服务都有消极的影响。云调用则致力于解决这类问题,借助抖音云托管与抖音小程序的生态闭环性,将开放能力的调用免鉴权化,抛弃传统 token 方式,简化开发者的开发负责度,提升开发体验。​
内网专线:抖音云为托管在云上的开发者服务,提供一条访问抖音开放能力服务的内网专线。比公网请求更稳定,更高效。​

使用方法​

云调用与自研模式区别​

云调用在使用上与自研模式基本一致,主要区别:​
    1.在抖音云上部署的服务中调用 OpenAPI 。​
    a.不再需要在请求参数或者 header 中添加 access_token ,将自动实现免鉴权的能力。​
    b.访问OpenAPI的域名需要把抖音开放平台的域名替换为云调用域名​
    2.云调用使用需要将HTTPS协议改为HTTP协议,云调用目前只支持 HTTP 协议​

举例说明​

以 OpenAPI 接口的文字检测接口为例,如果需要正常请求 OpenAPI 需要在请求 header 的 X-Token 字段添加 access_token。OpenAPI 都是 HTTP 形式提供,下面以 curl 请求 OpenAPI 接口,开发者可以根据自己所使用的语言进行调整。​
    自研模式:​
Shell
复制
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
    云调用模式:​
Shell
复制
curl -X POST -H "Content-type: application/json" \ -d '{"tasks": [{"content": "要检测的文本"}]}' \ http://developer-toutiao-com.openapi.dyc.ivolces.com/api/v2/tags/text/antidirt