# REST API

# API 入口地址

每个服务,有独立的 API 地址。以下为 已开放的服务 API 服务地址。

  • 云资源服务:http://resource-service.qiqiuyun.net

# 请求格式

对于 POST 和 PUT 请求,请求的主体必须是 JSON 格式,而且 HTTP header 的 Content-Type 需要设置为 application/json

每个请求需要设置 Authorization Http header,以表明请求合法性。Authorization Http header 生成算法如下。

使用 JWT 加密方式,参见 https://jwt.io/。


**加密参数**

| 名称      | 类型   | 必需 | 描述                                                                                                                                                  |
|-----------|--------|------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| jti       | String | 是   | 重放攻击的随机数,需16位长                                                                                                                            |
| exp       | String | 是   | 接口请求的过期时间                                                                                                                                    |

php 示例代码:

直接使用jwt的依赖包
$options = ['jti' => $jti,'exp' => $exp]
$token = JWT::encode($options, $secretKey, 'HS256', $accessKey);
$secretKey,$accessKey

携带Authorization到header里面,并拼接上Bearer $token,如: $header['Authorization'] = 'Bearer '.$token;