1 确定基本项目:

  命名规范(容易忽视的项目是版本号,漏掉会带来升级维护的困难),

  是否需要保持状态(建议不保持),

  使用什么做数据交换(建议 JSON ),

  是否需要使用 gzip https 等(建议使用),

  认证如何做

  等等。

  (参考: google RESTful 风格 )

  2 确定客户端和服务器的交互方式:

  是否需要分页,

  是否需要 Lazy loading ,

  异步提交等等。

  (很重要,而且和需求紧密相关。技术人员一定要和产品人员沟通好。

  这些都可能影响你的 API 设计。)

  3 设计功能 API:

  根据 1,2 ,你可以明确而且写出每个画面对应的所有 API。

  4 抽象和合并:

  把这些 API 重新抽象,是否需要增加通用 API ?是否可以合并 API ? API 是否需要分层?

  有现有系统?那么如何和现有 Web 服务连接?

  (很重要。可以有效降低风险,减少成本)

  5 排除负荷风险:

  对于可以预测的高负荷 API /大运算量 API 做优化。

  (设计和技术两方面。不要等到测出效率问题再考虑,那时候余地就有限了。

  办法很多,但是也很容易爆掉预算。事先做好预案和沟通总是没错的。)

  6 安排优先级

  项目管理的内容,不多说。

  7 编写测试代码:

  编写好所有的接口,然后准备测试代码。(参考:google TDD 模式)

  建议 github 找一个真正的项目结合上面的内容看。