一.API 简介
1.API 的概念
API(Application Programming Interface应用程序编程接口)是一些预定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码或理解内部工作机制的细节
2.API 的特点
API 是一个明确定义的接口,可以为其他软件提供特定服务
API可以小道只包含一个单独的函数,亦可以达到包含数以百计的类,方法,全局函数,数据类型,枚举类型和常量
API的实现可以是私有的,亦可以是开源的
3.API 的分类
面向对象语言的 API
库与框架的 API
API 与协议
API 与设备接口
Web API
4.使用 api 的原因
快速扩展功能
避免"造轮子",提高开发效率
降低模块之间的耦合度
二.api 的请求与认证
1.web api 协议及 http 请求
1.1 web api 一般采用 http 作为底层协议,http 请求机制如下:
客户端向服务器发送一个请求,服务器给客户端一个响应,告诉客户端是否可以完成它的请求的工作
1.2 http 请求包含的内容
客户端:url(api 请求地址),请求方式,headers(请求头),body(请求体)
headers请求头:提供请求的元信息,是一个简短的项目列表,其中有客户端发送请求的时间和请求主体的大小,身份认证等信息
body 请求体:包含客户端发送给服务器的数据
2.api 请求方式
get:请求服务器获取一个资源
post:请求服务器创建一个资源
put:请求服务器更新或者编辑一个资源
delete:请求服务器删除一个资源
3.状态返回码
处理成功返回2xx
200 ok-get:服务器成功返回用户请求的数据
201 created-post/put/patch:用户创建或修改数据成功