php写接口的一些注意事项和心得体会，大部分
参考别人的一些建议。
文档要写周全，需要的每个字段，规定是什么类型，什么含义要标柱清楚，写完接口后自己先测试一下是否通过，不要直接扔给测试或者开发，然后反应错误了在进行修改接口要做到小，同时比较多，切记一个接口的代码量很多。做到接口要小而多，不要做大而全，以方便减少服务器的压力在做app接口的返回值的数据类型时需要注意，弱语言和强语言的处理数据类型毕竟不同，比如空数组的返回至少要初始化一个，这样可以让一些客户端处理起来方便，而不会因为一些数据的不正常造成 crash，还有就是错误返回的标准统一周全，以及返回适当的错误提示当数据库里的字段发生变更时，要及时更新文档，并和使用到的程序员和测试人员说一声接口的测试（如果是node.js / mongodb 的搭配，也可以弄个自动化测试），测试要包含所有的返回情况，接口的规范，可以遵循 restfull api还有个需要注意的，可能是 content-type ，返回的是 json 数据，最好就是 application/json ，客户端一般都会用第三方的网络请求组件，而一些组件对 content-type 有严格的限制，当然这个需要和客户端的程序员确认，避免你明明返回 json 在 text 下可以正常显示，客户端却无法解析出来我们的接口一般是给app用的， 接口要加密。每次回话前 都向服务器请求token，服务器以session存储，回话结束，就销毁用restful，最好开启-黑夜路人
7、浅谈 php 与手机 app 开发，以前转的一偏文章，自己又改了一些东西，http://itlipeng/?p=707蜗牛
8、优秀api设计的十大原则http://itlipeng/?p=715蜗牛
9、what is the best way of session management in rest architecture?https://quora/what-is-the-best-way-of-session-management-in-rest-architecturetiyee