授权方式

更新时间:2024-06-13 08:22:17下载pdf

调用 API 时都需要进行令牌(Token)校验,然后授权。云开发 API 遵循 OAuth 2.0 协议标准,采用隐藏式(Implicit)授权方式。

简单模式

三方云涂鸦云换取访问令牌1. 根据 client_id 和 client_secret换取访问令牌 access_token1.1 返回访问令牌 access_token业务调用2. 调用业务接口2.1 返回业务接口执行结果三方云涂鸦云简单模式换取访问令牌

适用范围

适用于访问云项目下的数据,包括云项目下创建的数据和云项目关联的数据。

获取令牌接口示例

GET:/v1.0/token?grant_type=1
  • 必需参数:client_id (请求 header),secret (生成签名),grant_type(固定值 1)。
  • 相关文档:client_idsecret 查询方法详见 查询项目信息,签名算法详见 云授权签名机制,接口文档详见 获取令牌

数据来源和 API 权限范围

数据来源 API 权限范围
云项目关联 PID PID 权限包
云项目关联 App/微信小程序 App/微信小程序权限包
云项目关联用户 用户权限包

OAuth 2.0 授权模式

用户三方应用/浏览器三方云涂鸦云用户授权三方云1. 用户登录/扫码授权登录1.1 用户登录1.2 登录成功1.3 请求用户授权确认1.4 用户授权确认1.5 用户授权确认1.6 生成授权码(code),重定向授权码(code)换取-访问令牌2. 根据 client_id 和 client_secret code换取访问令牌 access_token2.1 返回访问令牌 access_token业务调用3. 调用业务接口3.1 返回业务接口执行结果用户三方应用/浏览器三方云涂鸦云OAuth 2.0 授权模式换取访问令牌

适用范围

适用于访问用户下的数据。

获取令牌接口示例

GET:/v1.0/token?grant_type=2&code=cf2xxxxxxxxxxxxxxxxxxxxxxxxxx8fe

如果您是在 终端 上使用 OAuth 2.0 授权模式client_id 请务必从 App 授权 创建。此类型的 client_id 更安全,能避免 终端client_idsecret 泄漏导致的大面积安全问题。

数据来源和 API 权限范围

数据来源 API 权限范围
用户通过网页授权方式 用户权限包