竭诚为您提供优质文档/双击可除

res接口协议

篇一：Restful接口规则(完整)

Restful接口设计规范

一、Restful简介

Rest是“Representationalstatetransfer”的缩写，

可以翻译成“表现状态转换”，但是在绝大多数场合中我们

只说Rest或者Restful。为什么会起这么一个奇怪的名字呢？我们可以从上述这篇论文中找到答案。Fielding在论文中将Rest定位为“分布式超媒体应用（distributedhypermediasystem）”的架构风格，它在文中提到一个名为“hateoas （hypermediaastheengineofapplicationstate）”的概念。

我们利用一个面向最终用户的web应用来对这个概念进行简单阐述：这里所谓的应用状态（applicationstate）表示web应用的客户端的状态，简单起见可以理解为会话状态。资源在浏览器中以超媒体的形式呈现，通过点击超媒体中的

链接可以获取其它相关的资源或者对当前资源进行相应的

处理，获取的资源或者针对资源处理的响应同样以超媒体的形式再次呈现在浏览器上。由此可见，超媒体成为了驱动客户端会话状态的转换的引擎。

借助于超媒体这种特殊的资源呈现方式，应用状态的转换体现为浏览器中呈现资源的转换。如果将超媒体进一步抽象成一般意义上的资源呈现（Repr

esentation）方式，那么应用状态变成了可被呈现的状态（Representationalstate）。应用状态之间的转换就成了可被呈现的状态装换（Representationalstatetransfer），这就是Rest。

二、运管平台/烽行平台Restful接口标准1.接口命名

规则

ip：服务器ip地址

端口：Restful端口号V2:版本号(2)接口名：

命名规则：现有接口方法去第一个单词后，全小写命名，如：

用户余额信息实时查询能力，原接口名：

querybalanceRealsingle(stringmsisdn)Restful接口:

2.参数规则

参数提交方式：application/www-form-urlencoded参

数命名：单词采取小写，复合词采取下划线分开的全小

写命名。

参数规则：批量查询需有page_size以及page_num参数，避免一次性查询，部分参数需有默认值设定。

附录：运管平台部分api规则用户状态查询：

status:0,message:"ok",result:{

status:’00’}}

短信失败记录历史查询：有list传递待定

lr_start_transaction("mnp_mock");

web_reg_save_param("response",

"lb=1.1",

"Rb=ok",

"ord=1",

"search=all",

"notfound=warning",

last);

web_custom_request("upload",

"uRl=http://ip:port/api/api/v1/service/push", "method=post",

"targetFrame=",

"Resource=1",

"Referer=",