公共参数
公共参数是用于标识用户和接口签名的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
公共参数的具体内容会因您使用的签名方法版本不同而有所差异。
## 公共参数说明:
公共参数需要统一放到 HTTP Header 请求头部中,如下表所示:
| 参数名称 | 类型 | 必选 | 描述 |
| ------------- | ------ | -- | ------------------------------------------------------------------------------------------------------- |
| Authorization | String | 是 | 身份验证参数,详见[签名方法](doc:vjdrSaVL) |
| X-Api-Time | String | 是 | 发送请求时间,格式为ISO8601,如 2022-08-16T17:23:23+08:00。用于在 Authorization 标头中创建签名的日期。注意:如果与服务器时间相差超过5分钟,会引起签名过期错误。 |
请求结构按照请求URL、请求头部、请求体示例如下:
HTTP GET 请求结构示例:
```
curl -X GET \
https://url \
-H 'Authorization: ***' \
-H 'X-Api-Time: 2022-08-16T17:23:23+08:00'
```
* DELETE同理。
HTTP POST(application/json) 请求结构示例:
```
curl -X POST \
https://url \
-H 'Authorization: ***' \
-H 'Content-Type: application/json' \
-H 'X-Api-Time: 2022-08-16T17:23:23+08:00' \
-d '{}'
```
* PUT、PATCH同理。