一、对接概述
提示：本文中所说的第三方云，指客户自己的用户管理系统(AM)、设备管理系统(DM)、支付系统(payment)等自有云服务。
本文将主要介绍第三方云服务如何对接TUTK的VSaaS，常见以下两种核心情形，第三方云需作为中间层与TUTK VSaaS进行交互，无需APP直接对接TUTK VSaaS接口：
1. APP不直接对接TUTK VSaaS，而是通过自己的云服务向TUTK VSaaS发起请求（如添加设备、删除设备、创建合约等）；
2. 第三方云在用户支付购买方案后，由第三方支付系统向TUTK VSaaS发起创建合约操作。
2. 第三方云在用户支付购买方案后，由第三方支付系统向TUTK VSaaS发起创建合约操作。
二、APP通过自有云对接TUTK VSaaS
当客户的APP不直接对接到TUTK的VSaaS，而是通过自身的云服务（如自有AM/DM）与TUTK VSaaS进行交互时，适用本对接方式。支持的核心操作包括添加设备、删除设备、创建合约等。
对接关键步骤：
1. 第三方云向TUTK申请专属的client_id和client_secret（用于身份认证）；
2. 第三方云通过client_id和client_secret向TUTK VSaaS发起请求，获取Oauth token（令牌有效期需参考TUTK VSaaS相关规范）；
3. 后续所有操作（如添加设备、删除设备等），第三方云均需携带该Oauth token向TUTK VSaaS发起请求；
4. 第三方云处理TUTK VSaaS的响应结果，并同步给自身APP。
2. 第三方云通过client_id和client_secret向TUTK VSaaS发起请求，获取Oauth token（令牌有效期需参考TUTK VSaaS相关规范）；
3. 后续所有操作（如添加设备、删除设备等），第三方云均需携带该Oauth token向TUTK VSaaS发起请求；
4. 第三方云处理TUTK VSaaS的响应结果，并同步给自身APP。
三、支付后第三方云创建合约对接
当用户在第三方平台完成云存方案支付后，由第三方支付系统触发与TUTK VSaaS的合约创建操作，适用于需通过自有支付系统完成交易闭环的场景。
对接关键步骤：
1. 第三方云向TUTK申请专属的client_id和client_secret；
2. 第三方云通过上述凭证获取Oauth token；
3. 用户在第三方平台完成支付后，第三方支付系统携带Oauth token向TUTK VSaaS发起合约创建请求（支持创建、修改、终止合约等操作）；
4. TUTK VSaaS返回创建成功的contract id（合约唯一标识）给第三方云；
5. 第三方云将绑定结果同步给APP端。
2. 第三方云通过上述凭证获取Oauth token；
3. 用户在第三方平台完成支付后，第三方支付系统携带Oauth token向TUTK VSaaS发起合约创建请求（支持创建、修改、终止合约等操作）；
4. TUTK VSaaS返回创建成功的contract id（合约唯一标识）给第三方云；
5. 第三方云将绑定结果同步给APP端。
