一、概述
本文將主要介紹第三方云服務(wù)如何對(duì)接TUTK的VSaaS，常見(jiàn)以下兩種核心情形，第三方云需作為中間層與TUTK VSaaS進(jìn)行交互，無(wú)需APP直接對(duì)接TUTK VSaaS接口：
1. APP不直接對(duì)接TUTK VSaaS，而是通過(guò)自己的云服務(wù)向TUTK VSaaS發(fā)起請(qǐng)求（如添加設(shè)備、刪除設(shè)備、創(chuàng)建合約等）；
2. 第三方云在用戶(hù)支付購(gòu)買(mǎi)方案后，由第三方支付系統(tǒng)向TUTK VSaaS發(fā)起創(chuàng)建合約操作。
2. 第三方云在用戶(hù)支付購(gòu)買(mǎi)方案后，由第三方支付系統(tǒng)向TUTK VSaaS發(fā)起創(chuàng)建合約操作。
二、APP通過(guò)自有云對(duì)接TUTK VSaaS
當(dāng)客戶(hù)的APP不直接對(duì)接到TUTK的VSaaS，而是通過(guò)自身的云服務(wù)（如自有AM/DM）與TUTK VSaaS進(jìn)行交互時(shí)，適用本對(duì)接方式。支持的核心操作包括添加設(shè)備、刪除設(shè)備、創(chuàng)建合約等。
對(duì)接關(guān)鍵步驟：
1. 第三方云向TUTK申請(qǐng)專(zhuān)屬的client_id和client_secret（用于身份認(rèn)證）；
2. 第三方云通過(guò)client_id和client_secret向TUTK VSaaS發(fā)起請(qǐng)求，獲取Oauth token（令牌有效期需參考TUTK VSaaS相關(guān)規(guī)范）；
3. 后續(xù)所有操作（如添加設(shè)備、刪除設(shè)備等），第三方云均需攜帶該Oauth token向TUTK VSaaS發(fā)起請(qǐng)求；
4. 第三方云處理TUTK VSaaS的響應(yīng)結(jié)果，并同步給自身APP。
2. 第三方云通過(guò)client_id和client_secret向TUTK VSaaS發(fā)起請(qǐng)求，獲取Oauth token（令牌有效期需參考TUTK VSaaS相關(guān)規(guī)范）；
3. 后續(xù)所有操作（如添加設(shè)備、刪除設(shè)備等），第三方云均需攜帶該Oauth token向TUTK VSaaS發(fā)起請(qǐng)求；
4. 第三方云處理TUTK VSaaS的響應(yīng)結(jié)果，并同步給自身APP。
三、支付后第三方云創(chuàng)建合約對(duì)接
當(dāng)用戶(hù)在第三方平臺(tái)完成云存方案支付后，由第三方支付系統(tǒng)觸發(fā)與TUTK VSaaS的合約創(chuàng)建操作，適用于需通過(guò)自有支付系統(tǒng)完成交易閉環(huán)的場(chǎng)景。
對(duì)接關(guān)鍵步驟：
1. 第三方云向TUTK申請(qǐng)專(zhuān)屬的client_id和client_secret；
2. 第三方云通過(guò)上述憑證獲取Oauth token；
3. 用戶(hù)在第三方平臺(tái)完成支付后，第三方支付系統(tǒng)攜帶Oauth token向TUTK VSaaS發(fā)起合約創(chuàng)建請(qǐng)求（支持創(chuàng)建、修改、終止合約等操作）；
4. TUTK VSaaS返回創(chuàng)建成功的contract id（合約唯一標(biāo)識(shí)）給第三方云；
5. 第三方云將綁定結(jié)果同步給APP端。
2. 第三方云通過(guò)上述憑證獲取Oauth token；
3. 用戶(hù)在第三方平臺(tái)完成支付后，第三方支付系統(tǒng)攜帶Oauth token向TUTK VSaaS發(fā)起合約創(chuàng)建請(qǐng)求（支持創(chuàng)建、修改、終止合約等操作）；
4. TUTK VSaaS返回創(chuàng)建成功的contract id（合約唯一標(biāo)識(shí)）給第三方云；
5. 第三方云將綁定結(jié)果同步給APP端。
