如何做一个api接口?
作为一名开发者,在此发表我的一些观点,一个好的Api一定是一个可读性比较高的Api项目。可以从以下几点入手
1、不论Api用何种语言编写,多少人编写,都需要达到每个接口的输出规则都是一致的。确定好开发前的开发规范,包括入参使用何种驼峰命名,返回的json数据又是以何种规则对外输出这些都需要在编码前考虑好。
2、Api需要对入参做必要验证。
5、考虑Api的响应速度可以适当的引用缓存技术,比如Redis。
6、做好项目的文档记录。
以上就是我的一些建议,我是一名开发人员,喜欢我的欢迎关注🍀🍀🍀🍀🍀🍀🍀
作为BAT的java开发工程师,来分享下我在公司里写的项目(脱敏)中的封装api接口部分。
我们使用的是SSM框架,但是这里其实不论是SSM还是SSH,抑或是spring BOOT,接下来的介绍都是通用的,因为主要是通过介绍注解(annotation),而不是xml文件。
首先,API接口需要出现在controller层,因此,在类名上方,需要至少两个注解,@controller,用于在项目启动的时候告诉spring,这个类是controller层的,需要加载好;@requestMapping,这个注解相当于指明了api的url中的一部分。
/dispatch
看完接下来我们看函数部分,这里首先也要加一个responseBody注解,这个注解的含义是将controller层中,函数的返回对象通过转换器,转换为指定的格式,写入到http response返回对象的body中去,也就是说下面这个函数返回的String,直接作为response的body内容返回给了用户。
接下来,依旧是requestMApping注解,相信大家也能了解了,复用上面的例子,当url为
现在的web开发基本都是多端共用同一Api,也就是当前最流行主导的前后端完全分离的模式去开发Api接口。
而我们通常用的最正规标准的又是Restful Api。就是在定义接口的时候不像以前那样随心所欲的想怎么定义就怎么定义,基本都是按照固定模式,达到见名知意基本不需要看接口注释就知道怎么调用。
就比如,现在大家都默认约定俗成的获取统一用Get请求,新增用Post请求,修改用Patch请求,删除用Delete请求,这样对于接口使用者从接口的请求方式就立马知道什么情况调用哪个指定接口,很方便高效。
然后类上面加上注解@RequestM***ing,这个注解要带上一个路径,这个路径会成为接口的一部分,然后再加上@RestController,这个注解是说明接口返回的数据格式为json,因为现在一般都是json数据格式交互
接下来在类里面新建一个方法,如下:
这时候我们还需要在方法上面再加上一个注解@RequestM***ing,或者@GetM***ing等其他注解
现在基本一个接口就定义完了,我们在方法中加一点信息返回给调用方,如下:
接下来我们启动项目,如下,启动成功
API(***lication Programming Interface,应用程序编程接口),目的是提供应用程序与开发人员基于某软件或硬件访问获取数据。
php[_a***_]示例:
***设接口访问地址 ***://127.0.0.1/api.PHP,api.php文件内容是
访问接口 ***://127.0.0.1/api.php