我自己设计接口的规范：

1. 接口是否使用签名
2. 接口是否有超时时间
3. 接口是否需要幂等性
4. 是否要过滤重复请求
5. 接口是否需要包含一些 debug 参数（仅仅在测试环境使用），比如：是否验证签名，是否验证超时时间，是否过滤重复请求，是否打印指定日志等等，主要目的是测试环境排错，生产环境的请求回放，压力测试等等
6. 接口可以新增参数，但是必须要向前兼容旧的接口
7. 接口尽量保持简单，同时降低耦合性，接口复用性
8. 接口参数哪些必要，哪些不必要，不必要参数设置默认值
9. 响应接口必要字段：code ，message ，timestamp ，result/data/value
10. 响应结果的 JSON 结构，优先使用非 Map 结构（ key 固定）


暂时想到这么多，可能还有些其它的，这个就要根据具体的场景来选择了。