客户端携带签名

## 客户端携带签名
简要描述：

- 服务端提升接口安全，开启了签名验证，防篡改、防重放
- 客户端发起请求时头部信息必须携带签名相关的参数
- 签名加密算法为 HmacSHA256

请求方式：

- get/post

请求头部(Header)：

- `X-API-KEY: xxxxxxxx`
- `X-API-NONCE: xxxxxxxx`
- `X-API-TIMESTAMP: xxxxxxxx`
- `X-API-SIGNATURE: xxxxxxxx`

参数：

| 参数名             | 是否必选 | 类型     | 说明                                                                                                                                         |
|-----------------|------|--------|--------------------------------------------------------------------------------------------------------------------------------------------|
| X-API-KEY       | 是    | String | 目标系统的API-KEY                                                                                                                               |
| X-API-NONCE     | 是    | String | 防重放攻击，生成一个随机字符串即可                                                                                                                          |
| X-API-TIMESTAMP | 是    | String | 发起请求时的Unix时间(毫秒)，Long类型，如：1681458047811                                                                                                    |
| X-API-SIGNATURE | 是    | String | 加密后的签名信息，使用X-API-NONCE + X-API-TIMESTAMP两个参数，再使用约定的API密钥进行加密，算法为HmacSHA256，最后再进行base64加密，最终加密后的字符串与后端加密的信息相匹配，才可以访问，否则视为非法请求,加密的代码示例可以参考文后 |

返回示例
```javascript
请求成功：
{
    "status": 200,
    ....
}
请求失败：
{
    "status": 500,
    "msg": "非法请求"
}
```

返回参数说明

| 参数名    | 类型     | 说明     |
|--------|--------|--------|
| status | int    | 返回状态码  |
| msg    | string | 返回错误消息 |

加密的代码示例：java语法
```javascript
   import javax.crypto.Mac;
    import javax.crypto.spec.SecretKeySpec;
    import java.nio.charset.StandardCharsets;
    import java.util.Base64;
    
   /**
    * 计算签名
    *
    * @param nonce     随机串
    * @param timestamp 时间字符串
    * @param secretKey API密钥
    * @return
    */
   private String calculateSignature(String nonce, String timestamp, String secretKey) {
       try {
           String message = nonce + timestamp;
           SecretKeySpec secretKeySpec = new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
           Mac mac = Mac.getInstance("HmacSHA256");
           mac.init(secretKeySpec);
           byte[] signatureBytes = mac.doFinal(message.getBytes(StandardCharsets.UTF_8));
           return Base64.getEncoder().encodeToString(signatureBytes);
       } catch (Exception e) {
           //
       }
       return null;
   }
```

### 备注