项目接口书写心得

Posted Mr_伍先生

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了项目接口书写心得相关的知识,希望对你有一定的参考价值。

 目前在公司的工作主要是写前端的接口工作,会和前端的同事配合比较多;这里记一下,自己在项目前端接口书写过程中的一些错误,减少再犯的可能性。

 

1.接口的返回值的格式

    --- list集合外面不需要再包一层(这里针对自己的项目而言)

 

2.接口的返回值和自己书写的文档要一致

   --- 返回值类型

   --- 返回值定义的名称

 

 

3.自己接口的业务逻辑要清楚,不要不知道自己这个接口是干嘛的?

 

 

4.有返回值就返回,没有的话,就是NULL

 --- 不要返回一个空的,但是没有值

 

 

5.如果这个接口方法定义是有返回值的,那么在接收完参数之后,要return 结果。

 --- 而不是继续让其往下执行(return map)

 

以上是关于项目接口书写心得的主要内容,如果未能解决你的问题,请参考以下文章

短信接口调用——阿里大于API开发心得

Restful风格接口书写规范

面向对象程序设计lesson2心得体会

接口心得

接口自动化测试持续集成--Soapui接口测试

C++接口设计的心得体会