公共参数
公共参数用于标识用户和接口签名的参数,每次请求均需要携带这些参数,才能正常发起请求。
公共参数
公共参数需要统一放到 HTTP Header 请求头部中。
参数名称 | 类型 | 必选 | 描述 |
---|---|---|---|
X-FZ-Timestamp | Int64 | 是 | HTTP 请求头:X-FZ-Timestamp。当前 UNIX 时间戳,单位:毫秒。 例如:1713098634859。注意:如果与服务器时间相差超过 5 分钟,会引起签名错误 |
Authorization | String | 是 | HTTP 标准身份认证头部字段。 例如:HmacSHA256 credential=1kl3pY,signature=be25c404a6d98df11256ba8d8f9e87658671148d99d9724d63aa2c12c1cc95e9 其中, -HmacSHA256:签名方法,目前固定取该值; -credential:签名凭证,1kl3pY是APPkey; -signature:签名摘要,计算过程详见文档。 |
HTTP GET 请求结构示例:
https://api.ffrcs.cn/rest/sms/v3/getBalance
Authorization: HmacSHA256 credential=1kl3pY,signature=be25c404a6d98df11256ba8d8f9e87658671148d99d9724d63aa2c12c1cc95e9
Content-type: application/x-www-form-urlencoded
X-FZ-Timestamp: 1713098634859
HTTP POST 请求结构示例:
https://api.ffrcs.cn/rest/sms/v3/signature/queryStatus
Authorization: HmacSHA256 credential=1kl3pY,signature=be25c404a6d98df11256ba8d8f9e87658671148d99d9724d63aa2c12c1cc95e9
Content-type: application/json;charset=utf-8
X-FZ-Timestamp: 1713098634859
{"signIdSet":[10,11]}