我觉得写一个接口应该考虑如下的内容：

1. 确定 url：是否符合 Restful，是否要符合公司确定的规范？
2. 确认操作人的权限
3. 确定要操作的资源的权限
4. 验证传入的参数：不要相信外面传进来的任何数据
5. 操作失败的提示
6. 操作成功的提示
7. 写文档：如何按规矩写好文档是一件值得花时间和精力梳理的事情
8. 如何测试接口，用什么数据测试

本文链接： http://lijinma.com/blog/2015/12/17/thinking-when-creating-a-web-api/