必须有版本编号，名称+版本，版本必须能区分历史版本。

RPC facade版本号不能使用SNAPSHOT版本结尾。

接口尽量建议一个接口做一件事。

不建议将一些关键字段开放参数来传递表明接口不同业务（特别是组合字段）。

不建议使用类型的默认值作为字段的业务说明。

1. 字符类型空或null。
2. 数字类型的0。

json 或 Java序列化。

json采用小写+“_”来表示key命名，最好指定解析json的包和版本。

json

fastjson

接口允许在指定超时时间内重试次数。

一般重试次数为接口平均响应时间3-5次（具体按业务情况）。

必须指明那些参数需要客户端验证（客户端不验证的，一般是服务端验证经常变更的），哪些服务端会验证。

输入参数中应包含接口请求时间和全局流水号。

字符、数字，最大最小建议使用闭区间，最大输入字段以业务为准（切记不要全量开放数据库字段限制，以后扩展就非常困难）。

日期明确指定格式。

枚举必须提供字典表。

返回结果必须有终态说明（提供逻辑表，表明业务F、S），不能有模糊区间。

枚举必须提供字典表。

字符、数字，必须提供大小，建议使用闭区间。

日期明确指定格式。

RPC对象返回结果代码中严重使用extends对象，防止变动影响范围无法控制。

返回值中尽量不要返回可选字段（可有可无的）。

Mock返回必须要特殊注明。

接口调用方必须提供代码示例。

http可以采用swagger。

RPC需要提供主流client语言支持，如java，其他语言如不支持，需要提供解决方法。