阿里巴巴软件互联平台技术规范
【IT168 信息化】
1. 接口交互规范
1.1 规范目的
为了确保软件互联平台与ISV应用，以及ISV 应用之间的交互，特制订本接口交互规范。
1.2 接口类型
根据接口的交互方，接口可以分为三类：
1）软件互联平台提供给ISV应用调用的接口(后续简称P4A接口)。
2）软件互联平台要求ISV应用实现的接口(后续简称A4P 接口，目前没有)。
3）ISV应用之间相互调用的接口(后续简称A4A接口，目前没有)。
1.3 接口形式
本接口交互规范要求以上三类接口均以WebService 形式提供，以确保软件互联平台与应用、应用之间的跨平台互操作性、良好的传输模型。
对于安全性要求较高的接口，还需通过Https 和WS-Security进一步保证接口交互的安全性。
2. 软件互联平台提供的接口
软件互联平台目前提供的接口列表如下：
以下为每个接口的详细信息：
2.1 validateUser
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：validateUser
功能描述：验证用户身份，确保用户已经登录软件互联平台，并且是该应用的有效使用用户，一般从Alisoft App Center跳转到ISV应用的身份验证过程中需要使用到。
接口参数：
返 回 值：
2.2 checkBalance
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：checkBalance
功能描述：检查应用订购者帐户余额，一般资源消耗类应用在开始消费前检查，以判断帐户余额是否足以进行本次消费。
接口参数：
返 回 值：
2.3 notifyBill
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：notifyBill
功能描述：产生一笔消费记录，并同时从应用订购者帐户扣费，一般资源消耗类应用在消费完成后调用。
接口参数：
返 回 值：
2.4 withhold
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：withhold
功能描述：预扣费方法可以进行消费额度冻结，调用成功则返回一个冻结（预扣费）ID，调用冻结失败返回错误码
接口参数：
返 回 值：
2.5 notifyBillWithhold
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：notifyBillWithhold
功能描述：此接口方法以实现真正的消费扣费。此方法与Core Service已经实现的应用消费扣费方法的不同在于需要传入冻结（预扣费）ID数组
接口参数：
返 回 值：
2.6 getSubscEndDate
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：getSubscEndDate
功能描述：此接口方法以实现获取订购者的订购服务的有效期至。
接口参数：
返 回 值：
2.7 getUsingUser
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：getUsingUser
功能描述：此接口方法以实现获取某个用户订购的应用的用户使用列表。
接口参数：
返 回 值：
2.8 validateAppUser
接口形式：WebService
提 供 方：软件互联平台
调 用 方：ISV应用
接口名称：getUsingUser
功能描述：此接口方法以实现验证某个用户是否某个订阅实例的有效用户。
接口参数：
返 回 值：
