Skip to main content

公共参数

公共参数用于标识用户和接口签名的参数,每次请求均需要携带这些参数,才能正常发起请求。

公共参数

公共参数需要统一放到 HTTP Header 请求头部中。

参数名称类型必选描述
X-FZ-TimestampInt64HTTP 请求头:X-FZ-Timestamp。当前 UNIX 时间戳,单位:毫秒。 例如:1713098634859。注意:如果与服务器时间相差超过 5 分钟,会引起签名错误
AuthorizationStringHTTP 标准身份认证头部字段。 例如: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]}