应用标准接入
接入准备
所有应用系统在接入得力E+云平台之前,首先开发商都必须通过开发者平台注册成为开发者,然后创建对应的应用,完成应用配置,并获取接入平台的密钥信息appId
和app_key
。
注意,应用接入配置信息包含测试和生产两套环境,开发者在研发阶段应使用测试环境的接入配置进行平台对接开发工作。研发结束发布上线时,方可对接到平台生产环境。
更多关于应用定义和配置的具体信息,请访问开发者平台获取。
接入方式
应用系统接入得力E+平台主要包括两个方面的对接:
- 服务器对接
- E+APP对接(可选)
服务器对接
所有云端应用统一采用HTTP协议+JSON数据交换格式与平台应用网关对接完成服务器对接。平台应用网关地址如下:
接入环境 | 接入地址 |
---|---|
测试环境 | http(s)://s-cloudapp.delicloud.com/gateway |
生产环境 | http(s)://cloudapp.delicloud.com/gateway |
为了方便大家对接,目前E+平台提供了java版本的应用网关对接SDK,最新版本请点击这里下载。
消息接收
应用在开发者平台创建应用时需要提供应用接收消息的Webhook地址,如下图所示:
一旦平台收到需要发送给应用的设备或者平台消息,平台会通过该Webhook地址将消息推送给应用。推送消息时,平台会携带签名确保消息的可靠性。具体细节请参考平台->应用指令4xx。
消息发送
应用如果需要向平台或者设备发送消息,可通过上述提供的应用网关地址发起HTTP请求,并携带合法的签名验证。具体细节请参考应用->平台指令5xx。
E+APP对接
对于某些没有独立入口的应用,可以通过与得力E+APP提供的JS-SDK对接,直接通过H5页面嵌入到得力E+APP内完成对接,成为E+APP内部的应用。
得力E+APP支持的终端对接范围包括移动APP(IOS & Android)、PC Web以及微信端。