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 找一个真正的项目结合上面的内容看。