联通WO+开放平台提供者指南(1)—API策略介绍.pdf

《联通WO+开放平台提供者指南(1)—API策略介绍.pdf》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、联通WO+开放平台提供者指南（1）—API策略介绍目录：1、流量控制策略1.1、速率控制2、安全控制策略2.1、IP接入控制2.2、Token认证2.3、开发者身份认证3、数据映射3.1、XMLtoXML3.2、XMLtoSOAP3.3、SOAPtoXML3.4、SOAPtoSOAP4、脚本增强4.1、MVEL4.2、XSLT1、流量控制策略1.1、速率控制使用场景此策略控制API的全局并发调用速率。指调用部署在商用环境的API所有请求速率之和不能超过此处配置的值。并发请求数超限时，超过的请求将被拒绝并返回错误响应。此策略可用于保护后端A

2、PI服务器免受大数据量冲击，能力提供者可以根据后端API服务器性能调整来修改策略中的配置值。配置说明在流程编排图中单击此策略图标，并参考表1配置速率控制策略。表1参数说明参数说明您可以配置10至500的TPS值。说明：TPS此策略默认值为100TPS。即如果您不配置此策略，WO+能力共享平台按100TPS控制商用环境API请求速率。2、安全控制策略2.1、IP接入控制使用场景此策略通过配置IP地址白名单或IP地址黑名单的方式对所有的API调用请求进行鉴权，允许来自IP白名单中的访问请求接入系统，或拒绝来自IP黑名单中的访问。您可以通过配置

3、此策略提升安全性。例如在发现网络攻击后，可以通过配置此策略拒绝来自攻击地址的API调用请求。或者开发API时配置IP白名单，仅允许来自IP白名单的请求消息接入。配置说明将IP接入控制策略图标拖拽至流程编排图中，并根据表1配置IP接入控制策略。表1IP策略配置示例场景填写说明仅允许单个IP如10.10.10.10的“允许访问的IP地址”填写为允许访问的IP地址，子网掩IP访问API。码设为“255.255.255.255”。仅拒绝某段地址如10.10.10.*的“拒绝访问的IP地址”填写为拒绝访问的IP地址，子网掩所有地址访问API。码设为

4、“255.255.255.0”。2.2、Token认证使用场景此策略表示开发者调用API时，首先需要调用WO+能力共享平台提供的获取Token接口来获取“Token”。开发者应用调用业务接口时携带已获取的“Token”信息，WO+能力共享平台对“Token”进行鉴权认证。认证通过后WO+能力共享平台处理开发者应用的接口请求，认证失败则拒绝处理开发者应用的接口请求。配置说明您只需将Token认证策略图标拖拽到流程编排图中，无需为此策略配置任何参数。2.3、开发者身份认证使用场景此策略表示开发者调用API时，需提供“UserID+API调用密

5、码”用于身份认证，认证通过后才处理开发者应用的接口请求，认证失败则拒绝处理开发者应用的接口请求。配置说明您只需将开发者身份认证策略图标拖拽到流程编排图中，无需为此策略配置任何参数。3、数据映射3.1、XMLtoXMLXMLtoXML策略是WO+能力共享平台提供的一种将App发送的HTTP+XML格式的请求消息转换为另外一种HTTP+XML格式消息的控制策略。能力提供者无需编码，只需要应用该策略即可快速实现XML格式消息之间的字段转换、映射、屏蔽。实现原理XMLtoXML策略的实现原理如图1所示。图1实现原理使用场景能力提供者无需编码，通过

6、拖拽额策略即可实现XML格式消息之间的字段转换、映射、屏蔽等。此策略可以应用于如图2所示的几种场景。图2使用场景配置说明在配置此策略前，能力提供者需要准备好XML消息定义文件。WO+能力共享平台支持的XML消息定义文件后缀名为“.xsd”。完成消息文件的定义后，能力提供者可以将图标拖拽至策略编排流程图中并按照界面提示进行操作即可。3.2、XMLtoSOAPXMLtoSOAP数据映射是WO+能力共享平台提供的一种将App发送的HTTP+XML格式消息转换为SOAP格式消息的控制策略。能力提供者无需编码，只需应用该策略即可快速实现对API的接

7、口字段映射、屏蔽和消息格式转换。此策略通常和SOAPtoXML策略配合使用，例如发送请求消息时配置XMLtoSOAP策略将请求消息从XML转换为SOAP，则同时需要配置SOAPtoXML策略将响应消息从SOAP转换为XML格式。实现原理XMLtoSOAP策略的实现原理如图1所示。图1实现原理使用场景能力提供者无需编码，通过拖拽额策略即可实现XML格式消息到SOAP格式消息之间的字段转换、映射、屏蔽等。此策略可以应用于如图2所示的几种场景。图2使用场景配置说明在配置此策略前，能力提供者需要准备好XML消息定义文件和SOAP消息定义文件。WO

8、+能力共享平台支持的XML消息定义文件后缀名为“.xsd”，SOAP消息定义文件后缀名为“.wsdl”或“.xsd”。完成消息文件的定义后，能力提供者可以将图标拖拽至策略编排流程图中并按照界面