Apsara Clouder专项技能认证：实现调用API接口——学习笔记

无意中翻到了阿里云的推广链接，领了个免费的学习资源，顺便考了个免费的证书，虽然没啥东西，但还是要记录下学习内容。
证书很好考，现在的学习视频还是免费的（估计是永久免费的吧，应该是阿里为了推广他的API市场而造的），学习地址：
https://edu.aliyun.com/course/416?source=5176.11533457&userCode=3hsmglt2&type=copy

一、关于API的介绍

概念：

API(Application Programming Interface, 应用程序编程接口）是一些预先定义的函数， 目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码或理解内部工作机制的细节。

特点：

API是一个明确定义的接口，可以为其他软件提供服务；
API小到只包含一个函数，大到包含数以百计的类、函数、常量、枚举类型等；
API的实现可以是私有的，也可以是开源的；

种类：

面向对象语言的API，如Java API列表；
库与框架的API，如Windows API；
API与协议，LDAP应用程序接口；
API与设备接口；
Web API，Google地图API、新浪微博API、阿里云API市场；

好处：

快速扩展功能；
提高开发效率；
降低耦合度；

二、API请求与认证

Web API协议：

采用http作为底层协议，客户端与服务端的开发语言无关。

http请求包含的内容：

URL（调用地址）
请求方法
请求头（Headers)
请求体（Body）

常见的请求方式：

GET：请求服务器获取一个资源
POST：请求服务器创建一个新的资源
PUT：请求服务器编辑或更新一个已存在的资源
DELETE：请求服务器删除一个资源

状态码

200：请求并返回数据成功
201：用户新建或修改数据成功
202：请求已进入后台排队
204：用户删除数据成功
500：API网关内部错误、底层服务错误
503：服务不可用
504：后端服务超时
5开头的一般都是服务端的状态。

返回数据格式

分为JSON和XML格式，一般采用JSON格式。
JSON对象格式：

{
	"name":"电脑",
	"price":"6999"
}

JSON数组格式：

{
	"name":"电脑",
	"products":[
		{
			"brand":"华为",
			"price":"5489"
		},
		{
			"brand":"戴尔",
			"price":"3568"
		},
	]
}

身份认证

调用API需要进行身份认证，身份认证分为两种，一种是简单认证，一种是加密认证。

简单认证

通过APPCODE的方式进行认证。在请求头中添加Authorization字段，字段值为：”APPCODE + 半角空格 + APPCODE值“
示例：
Authorization:APPCODE 3EFSDF325FDT4EWWFSFR23SSSSR2FSDA

API签名认证：AppKey&AppSecret加密认证

三、API调试与调用

调用API的三个基础条件：
拥有一个API，明确API的参数定义。
应用APP，作为调用API时的身份。
API和APP的权限关系，即拥有调用API的权限。
阿里云API的调用需要注意：
每个账号下APP个数上线为10，且名称在该账号下是唯一的。
调用API流控限制为单个IP，QPS不超过100.
我们有权操作购买的API与APP的授权和解除授权，但是对于服务方直接授权给我们的APP的API，我们无权解除授权。
API具体的操作很简单，可以直接看官方文档即可。
阿里云的官方API地址：
https://market.aliyun.com/data?source=5176.11533457&userCode=3hsmglt2&type=copy