# 公共参数

公共参数是用于标识用户和接口签名的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。公共参数需要统一放到请求串中。

序号 参数名称 类型 必选 描述
1 SecretId string 从超级管理员处申请分配的标识身份的 SecretId。
一个 SecretId 对应唯一的 SecretKey ,而 SecretKey 会用来生成请求签名 Signature。
2 Timestamp string 当前 UNIX 时间戳,取毫秒。可记录发起生成Signature 的时间。
例如:1618235242820,如果与当前时间相差过大,会引起签名过期错误。
3 Signature string 签名

假设用户想要查询所有图片类型的数据集列表,其请求结构按照请求 URL、请求头部、请求体示例如下:

HTTP GET 请求结构示例:

{
    https://url/api/v1/datasets?SecretId=AKIDz8krbsJ5yKBZQpn74WFkmLPx3eh2&Signature=fdae105fbdd459f3ada5b728dc345cfb6e54cb3c5c8e12824c31ba6850892ed5&Timestamp=1618235242820&Type=0
    Host: url
    Content-Type: application/x-www-form-urlencoded
}