前言

快速刷了一下阿里云的API课程,内容不多,大致介绍了一下相关基础。课程共4课,主要是为了让大家知道阿里云提供了API商店哈哈哈哈哈。

HTTP请求包含的内容

  • URL:API调用地址
  • Method:请求方式

    • GET:请求获取
    • POST:请求创建新资源
    • PUT:请求编辑或更新一个已存在资源
    • DELETE:请求删除
  • Headers:请求头 User-Agent

    • 请求元信息,一个简单的项目列表
    • 客户端发送请求时间、请求主体大小、身份认证等信息
  • Body:请求主体 Data

    • 包含了客户端希望发送给服务器的数据

状态码:请求状态

2xx:成功
5xx:失败(也有可能是4xx)
状态码可能是api服务商自定义的。

返回数据格式

JSON、XML两种居多,最新API一般为JSON

JSON数据格式表示方法

  1. 表示对象:对象的键值对(最常用)方式为大括号{}
{"name":"黑龙江","city":"哈尔滨"}
  1. 表示数组:方式为方括号[]
{
    "name":"China",
    "province":[{
        "name":"黑龙江",
        "city":"哈尔滨"},
        {"name":"广东",
        "city":"广州"}
    }]
}

API身份认证

API简单身份认证(APPCODE)

方法:

  1. Header中添加的Authorization字段
  2. 配置Authorization字段值为"APPCODE+半角空格+APPCODE值"

示例:

Authorization:APPCODE 3F435346D3244IJ4525436C01

API签名认证(AppKey&AppSecret)

满足更高的安全要求

API调用步骤

获取API文档>创建应用>获取授权>调用API