集成概述
虚商是阿里云重要的渠道伙伴模式。阿里云提供集成能力,帮助虚商伙伴建设独立的云平台。本文介绍虚商伙伴平台与阿里云服务集成的前提、方案、流程、测试账号以及 API 参考。
集成前提
建设自有平台。
开通阿里云账号,详情请参见阿里云账号注册流程
线上申请虚商伙伴业务。
签订商务合同。
集成方案
虚商伙伴想要建设完整的云平台,需要将自有平台(包括客户管理、账单结算等模块)与阿里云产品相关的云账号管理,安全访问,云资源购买、开通及管理,账单,计量数据,备案,消息通知,工单升级等服务进行集成。该云平台支持虚商客户从注册到云资源购买、开通、管理、账务结算及查询、售后服务的完整消费周期。您也可根据实际情况选择仅集成阿里云账号管理、安全访问,实现客户从虚商平台注册后,免登录进入阿里云购买和管理资源。
虚商集成方案提供了阿里云资源的集成转售能力。虚商集成支持以下两种方案:
服务化套件集成
阿里云提供集成的服务化套件,将售卖、管理、备案、费用查询等功能集成到伙伴平台。该方案集成工作量小,提升了客户体验,您仅需关注客户管理和业务本身。
API 集成
基于产品封装、伙伴定价等需求,产品售卖页、备案服务可以通过集成云产品实例 API 来开发。由于控制台功能复杂,因此在 API 集成方案中仍建议采用服务化套件集成。
两种方案的区别在于售卖页、备案服务和费用中心环节的集成方式不同。服务化套件集成方案对售卖页、备案服务、和费用中心进行服务化集成,而 API 集成方案则需要调用阿里云提供的售卖相关 API 和备案服务相关 API,和订单/账单相关API开发集成。
服务化套件
阿里云把常用的页面模块化,对虚商伙伴输出了BUY页面和console页面,并且可以套用不同的云产品来使用。虚商伙伴只需通过iframe嵌入即可,底层调用的还是OpenAPI,此套方案可代替虚商伙伴完成模块开发。
服务化套件集成方案可以减少虚商伙伴的开发工作量,加速开发进度,因整个套件使用的商业标准与阿里云完全对齐,故不支持个性化配置。
OpenAPI集成
BUY页面,阿里云侧梳理商品的整个售卖生命周期,对应做了一套bss接口。所有接入的产品都通过统一的接口完成创建,升降变配,释放等事务。
CONSOLE页面,由于控制台业务逻辑过于复杂,开发成本巨大且得不偿失。建议不要尝试。
伙伴通过接口自研发自己的BUY&CONSOLE页面。
API集成的优缺点与服务化套件互补。
那么伙伴在集成过程中,需要结合自己的业务特性来选择,颗粒度到产品。如果没有特殊需求,建议使用服务化套件。
也可以在项目前期使用服务化套件,在开发完成后切换到自研buy页面。
特殊需求举例:
1.伙伴Portal有自营产品例如ECS,想要捆绑阿里云虚商渠道产品VPC,一起售卖给终端客户。这种情况服务化套件不支持这种个性化商业策略,只能走API方案实现。
2.伙伴想要对阿里云虚商渠道产品自定义配置价格。服务化套件的价格与官方对齐,不支持配置。只能走API方案实现。
免登访问的有效时间周期为 1 小时。因此如果备案服务选择服务化集成,那么虚商客户需要在 1 小时内完成备案,否则会因为免登 Token 失效而导致备案失败。
集成流程
SDK参考请参见参考文档。
API 分类 | 参考文档 |
安全访问 | |
实名认证 | |
预算管理 | |
备案服务 | |
工单服务 |
虚商平台与阿里云集成流程如下图所示。单击图片中的集成步骤可以打开该步骤下调用相关 API 的调用场景或调用说明的文档,单击图片中 API 接口名称可打开对应的 API 参考文档。
虚商平台集成相关的 API 调用方式请参见请求结构、公共参数、签名机制。
-
账号 API 集成
-
CreateAgAccount
-
GetCustomerAccountInfo
-
GetCustomerList
-
-
角色扮演及安全访问 API 集成
-
AssumeRole
-
GetSigninToken
- Login
-
-
实名认证 API 集成
-
GenerateAliyunBidCertWaysUrl
-
RemoveIdentityCertifiedForBidUser
-
QueryBidUserCertifiedInfo
-
-
预算管理 API 集成
-
CreateResellerUserQuota
- SetResellerUserQuota
- QueryResellerAvailableQuota
- ChangeResellerConsumeAmount
- SetResellerUserStatus
- SetResellerUserAlarmThreshold
-
-
售卖页服务化集成或 API 集成
-
查询产品信息 API
-
QueryProductList
- DescribePricingModule
- GetSubscriptionPrice
- GetPayAsYouGoPrice
-
-
除 ECS、RDS 外产品售卖页 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
-
-
-
控制台服务化集成
-
订单/账单 API 集成
-
QueryOrders
- GetOrderDetail
- CancelOrder
- SubscribeBillToOSS
- UnsubscribeBillToOSS
-
-
备案服务化集成或 API 集成
-
ProductBindBsn
- GetBsnSySn
- GetBsnByResource
- GrantBsnCode
-
-
-
售后及其他 API 集成
-
消息服务
-
ReceiveMessage
-
-
工单服务(单击查看调用场景)
-
Add
- QuestionReply
- QuestionListNote
- QuestionList
- getOSSTempAuthor
- getAttachTempURL
-
-
申请测试账号
在您正式开通售卖业务之前,可申请开通测试账号。
测试账号可用于测试以下服务:
创建或查询客户账号
实名认证
安全访问
OpenAPI 调用
测试账号开通步骤:
测试账号在测试阶段结束后,可选做正式账号。
测试账号有效期为 1 个月,一个测试账号最多可创建 20 个客户账号。
集成项目
伙伴完成了账号申请,虚商入驻申请,进入了虚商集成阶段。我们将分派虚商接口人帮助伙伴完成这一过程,直到项目上线和商业化。
过程中,还需要伙伴完成aps平台的集成流程和产品接入&调试。
Aliyun Partner Service 集成流程。
Aliyun Partner Service 产品授权申请。