1.2 公共参数
优质
小牛编辑
139浏览
2023-12-01
公共参数
公共参数是所有 API 请求都必需的参数。
注解 为减少内容重复,公共参数就不在各 API 详情中列出了。
Name | Description | Notes |
---|---|---|
action | 每个API 都有自己的action ,用来标识所请求指令。例如GetBrands 。 | 此参数体现在url中,完整的指令名称列表请参见 API指令列表。 |
time_stamp | 请求串生成时间,格式为YYYY-MM-DDThh:mm:ssZ 或者unix时间戳,例如 2015-08-27T13:58:35Z ,具体格式可以参见 ISO8601。 | 这个时间为北京 时间,假设您的本地时间非UTC+8 ,您需要将其转化为 UTC+8 的时间。当然了,这里也可以使用unix时间戳 1440683915 |
live_time | 请求有效时间 | 单位为秒,如果请求时间跟星图服务器时间差距超过live_time,请求无效,请参见错误码列表 |
access_key_id | 申请的API密钥ID ,例如QYACCESSKEYIDEXAMPLE 。 | 开发者可以向星图申请获取此值最为身份id |
signature | 请求消息的签名,计算、生成方式参考右边 | MD5(time_stamp+access_key_id+secret_access_key) 注意:参与运算的time_stamp为unix时间戳 |