公共参数

公共参数是用于标识用户和接口签名的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。 公共参数的具体内容会因您使用的签名方法版本不同而有所差异。 ## 公共参数说明: 公共参数需要统一放到 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同理。