1. 云之家oauth2.0授权协议

云之家对外开放的接口都需要通过云之家OAuth2.0授权协议获取到accessToken进行授权后才能访问，目前云之家接口资源授权级别可分为三大类，分别为app，team，resGroupSecret。

1.1. 接口调用流程示意图

开发者轻应用开发注意事项:

云之家开放平台接口面向的是服务端调用，如果直接通过HTML端JS请求：

1. 会有ajax跨域问题;
2. 如果把相关密钥信息配置于前端JS或配置文件极容易导致信息泄漏造成不可挽回的后果;

云之家标准接口调用流程示意图如下：

1.2. API与授权级别对照表

不同业务对应的接口资源授权级别，请参考下表：

1.3. 获取accessToken接口

描述： 获取对应业务接口的授权accessToken；

网络传输协议： HTTPS

请求地址： https://www.yunzhijia.com/gateway/oauth2/token/getAccessToken

请求方法： POST

内容类型： Content-Type: application/json

输入参数:

• 授权级别为app时，接口请求参数如下：

JSON示例:

{
    "appId": "xxxxxx",
    "secret": "轻应用secret",
    "timestamp": 1522305194157,
    "scope": "app"
}

• 授权级别为resGroupSecret时，接口请求参数如下：

JSON示例:

{
    "eid": "xxxxxx",
    "secret": "资源授权秘钥secret",
    "timestamp": 1522305194157,
    "scope": "resGroupSecret"
}

• 授权级别为team时，接口请求参数如下：

JSON示例:

{
    "appId": "xxxxxx",
    "eid": "xxxxxx",
    "secret": "轻应用secret",
    "timestamp": 1522305194157,
    "scope": "team"
}

输出结果:

{
  "data": {
      "accessToken":"accessToken",
      "expireIn":有效时间(秒),
      "refreshToken":"token刷新令牌"
  },
  "errorCode": 0,
  "success": true
}

1.4. 刷新accessToken

描述： 企业开发者通过获取accessToken接口得到token刷新令牌，刷新accessToken；

网络传输协议： HTTPS

请求地址：https://www.yunzhijia.com/gateway/oauth2/token/refreshToken

请求方法：POST

内容类型：application/json

输入参数:

• 授权级别为app时，接口请求参数如下：

• 授权级别为team时，接口请求参数如下：

• 授权级别为resGroupSecret时，接口请求参数如下：

输出结果:

{
  "data": {
      "accessToken":"accessToken",
      "expireIn":有效时间(秒),
      "refreshToken":"token刷新令牌"
  },
  "errorCode": 0,
  "success": true
}

1.5. FAQ