集成概述
虛商是阿里云重要的渠道伙伴模式。阿里云提供集成能力,幫助虛商伙伴建設(shè)獨(dú)立的云平臺。本文介紹虛商伙伴平臺與阿里云服務(wù)集成的前提、方案、流程、測試賬號以及 API 參考。
集成前提
建設(shè)自有平臺。
開通阿里云賬號,詳情請參見阿里云賬號注冊流程
線上申請?zhí)撋袒锇闃I(yè)務(wù)。
簽訂商務(wù)合同。
集成方案
虛商伙伴想要建設(shè)完整的云平臺,需要將自有平臺(包括客戶管理、賬單結(jié)算等模塊)與阿里云產(chǎn)品相關(guān)的云賬號管理,安全訪問,云資源購買、開通及管理,賬單,計(jì)量數(shù)據(jù),備案,消息通知,工單升級等服務(wù)進(jìn)行集成。該云平臺支持虛商客戶從注冊到云資源購買、開通、管理、賬務(wù)結(jié)算及查詢、售后服務(wù)的完整消費(fèi)周期。您也可根據(jù)實(shí)際情況選擇僅集成阿里云賬號管理、安全訪問,實(shí)現(xiàn)客戶從虛商平臺注冊后,免登錄進(jìn)入阿里云購買和管理資源。
虛商集成方案提供了阿里云資源的集成轉(zhuǎn)售能力。虛商集成支持以下兩種方案:
服務(wù)化套件集成
阿里云提供集成的服務(wù)化套件,將售賣、管理、備案、費(fèi)用查詢等功能集成到伙伴平臺。該方案集成工作量小,提升了客戶體驗(yàn),您僅需關(guān)注客戶管理和業(yè)務(wù)本身。
API 集成
基于產(chǎn)品封裝、伙伴定價等需求,產(chǎn)品售賣頁、備案服務(wù)可以通過集成云產(chǎn)品實(shí)例 API 來開發(fā)。由于控制臺功能復(fù)雜,因此在 API 集成方案中仍建議采用服務(wù)化套件集成。
兩種方案的區(qū)別在于售賣頁、備案服務(wù)和費(fèi)用中心環(huán)節(jié)的集成方式不同。服務(wù)化套件集成方案對售賣頁、備案服務(wù)、和費(fèi)用中心進(jìn)行服務(wù)化集成,而 API 集成方案則需要調(diào)用阿里云提供的售賣相關(guān) API 和備案服務(wù)相關(guān) API,和訂單/賬單相關(guān)API開發(fā)集成。
服務(wù)化套件
阿里云把常用的頁面模塊化,對虛商伙伴輸出了BUY頁面和console頁面,并且可以套用不同的云產(chǎn)品來使用。虛商伙伴只需通過iframe嵌入即可,底層調(diào)用的還是OpenAPI,此套方案可代替虛商伙伴完成模塊開發(fā)。
服務(wù)化套件集成方案可以減少虛商伙伴的開發(fā)工作量,加速開發(fā)進(jìn)度,因整個套件使用的商業(yè)標(biāo)準(zhǔn)與阿里云完全對齊,故不支持個性化配置。
OpenAPI集成
BUY頁面,阿里云側(cè)梳理商品的整個售賣生命周期,對應(yīng)做了一套bss接口。所有接入的產(chǎn)品都通過統(tǒng)一的接口完成創(chuàng)建,升降變配,釋放等事務(wù)。
CONSOLE頁面,由于控制臺業(yè)務(wù)邏輯過于復(fù)雜,開發(fā)成本巨大且得不償失。建議不要嘗試。
伙伴通過接口自研發(fā)自己的BUY&CONSOLE頁面。
API集成的優(yōu)缺點(diǎn)與服務(wù)化套件互補(bǔ)。
那么伙伴在集成過程中,需要結(jié)合自己的業(yè)務(wù)特性來選擇,顆粒度到產(chǎn)品。如果沒有特殊需求,建議使用服務(wù)化套件。
也可以在項(xiàng)目前期使用服務(wù)化套件,在開發(fā)完成后切換到自研buy頁面。
特殊需求舉例:
1.伙伴Portal有自營產(chǎn)品例如ECS,想要捆綁阿里云虛商渠道產(chǎn)品VPC,一起售賣給終端客戶。這種情況服務(wù)化套件不支持這種個性化商業(yè)策略,只能走API方案實(shí)現(xiàn)。
2.伙伴想要對阿里云虛商渠道產(chǎn)品自定義配置價格。服務(wù)化套件的價格與官方對齊,不支持配置。只能走API方案實(shí)現(xiàn)。
免登訪問的有效時間周期為 1 小時。因此如果備案服務(wù)選擇服務(wù)化集成,那么虛商客戶需要在 1 小時內(nèi)完成備案,否則會因?yàn)槊獾?Token 失效而導(dǎo)致備案失敗。
集成流程
SDK參考請參見參考文檔。
API 分類 | 參考文檔 |
安全訪問 | |
實(shí)名認(rèn)證 | |
預(yù)算管理 | |
備案服務(wù) | |
工單服務(wù) |
虛商平臺與阿里云集成流程如下圖所示。單擊圖片中的集成步驟可以打開該步驟下調(diào)用相關(guān) API 的調(diào)用場景或調(diào)用說明的文檔,單擊圖片中 API 接口名稱可打開對應(yīng)的 API 參考文檔。
虛商平臺集成相關(guān)的 API 調(diào)用方式請參見請求結(jié)構(gòu)、公共參數(shù)、簽名機(jī)制。
-
賬號 API 集成
-
CreateAgAccount
-
GetCustomerAccountInfo
-
GetCustomerList
-
-
角色扮演及安全訪問 API 集成
-
AssumeRole
-
GetSigninToken
- Login
-
-
實(shí)名認(rèn)證 API 集成
-
GenerateAliyunBidCertWaysUrl
-
RemoveIdentityCertifiedForBidUser
-
QueryBidUserCertifiedInfo
-
-
預(yù)算管理 API 集成
-
CreateResellerUserQuota
- SetResellerUserQuota
- QueryResellerAvailableQuota
- ChangeResellerConsumeAmount
- SetResellerUserStatus
- SetResellerUserAlarmThreshold
-
-
售賣頁服務(wù)化集成或 API 集成
-
查詢產(chǎn)品信息 API
-
QueryProductList
- DescribePricingModule
- GetSubscriptionPrice
- GetPayAsYouGoPrice
-
-
除 ECS、RDS 外產(chǎn)品售賣頁 API
-
CreateInstance
- QueryAvailableInstances
- ModifyInstance
- RenewInstance
- SetRenewal
- ConvertChargeType
- DescribeResourcePackageProduct
- GetResourcePackagePrice
- CreateResourcePackage
- QueryResourcePackageInstances
- RenewResourcePackage
- UpgradeResourcePackage
-
-
ECS 售賣頁 API
-
RunInstances
- DescribeAvailableResource
- Describeprice
- DescribeInstances
- ModifyInstanceSpec
- ModifyPrepayInstanceSpec
- ModifyInstanceNetworkSpec
- RenewInstance
- ReactivateInstances
- DeleteInstance
- PurchaseReservedInstancesOffering
- DescribeReservedInstances
- ModifyReservedInstances
-
-
RDS 售賣頁 API
-
CreateDBInstance
- RenewInstance
- DeleteDBInstance
- ModifyDBInstanceSpec
- DescribeAvailableResource
- CreateReadOnlyDBInstance
- ModifyDBProxy
- ModifyDBProxyInstance
- CreateBackup
- ModifyBackupPolicy
- ModifySQLCollectorPolicy
- CloneDBInstance
- RestoreTable
- RecoveryDBInstance
- CreateDdrInstance
- ModifyInstanceCrossBackupPolicy
-
-
-
控制臺服務(wù)化集成
-
訂單/賬單 API 集成
-
QueryOrders
- GetOrderDetail
- CancelOrder
- SubscribeBillToOSS
- UnsubscribeBillToOSS
-
-
備案服務(wù)化集成或 API 集成
-
ProductBindBsn
- GetBsnSySn
- GetBsnByResource
- GrantBsnCode
-
-
-
售后及其他 API 集成
-
消息服務(wù)
-
ReceiveMessage
-
-
工單服務(wù)(單擊查看調(diào)用場景)
-
Add
- QuestionReply
- QuestionListNote
- QuestionList
- getOSSTempAuthor
- getAttachTempURL
-
-
申請測試賬號
在您正式開通售賣業(yè)務(wù)之前,可申請開通測試賬號。
測試賬號可用于測試以下服務(wù):
創(chuàng)建或查詢客戶賬號
實(shí)名認(rèn)證
安全訪問
OpenAPI 調(diào)用
測試賬號開通步驟:
注冊阿里云賬號,并完成實(shí)名認(rèn)證。詳情請參見阿里云賬號注冊流程和企業(yè)實(shí)名認(rèn)證。
由阿里云正式員工為您申請測試賬號。
測試賬號在測試階段結(jié)束后,可選做正式賬號。
測試賬號有效期為 1 個月,一個測試賬號最多可創(chuàng)建 20 個客戶賬號。
集成項(xiàng)目
伙伴完成了賬號申請,虛商入駐申請,進(jìn)入了虛商集成階段。我們將分派虛商接口人幫助伙伴完成這一過程,直到項(xiàng)目上線和商業(yè)化。
過程中,還需要伙伴完成aps平臺的集成流程和產(chǎn)品接入&調(diào)試。
Aliyun Partner Service 集成流程。
Aliyun Partner Service 產(chǎn)品授權(quán)申請。