安全要求及报文格式
消息协议
报文内容
请求/响应 Header
| Header Parameters | Description |
|---|---|
| Content-Type | 指定“application/json; charset=utf-8”，请求和响应的消息正文必须是JSON格式，并且字符编码为UTF-8。响应中也会回复该字段。 |
| DateTime | 请求发送的时间，格式遵循ISO8601：YYYY-MM-DDThh:mm:ssTZD，响应中也会回复该字段。 |
| KeyID | 由EVO Cloud分配的签名密钥的唯一标识符。在响应和请求中，这个标识符应该是相同的，并且可以作为可选项发送。 |
| MsgID | 这是一个用于追踪商家的每一个API请求的ID。建议使用UUID（通用唯一识别码）或GUID（全局唯一标识符），例如2d21a5715c034efb7e0aa383b885fc7a。建议将此值的长度控制在不超过32个字符。EVO Cloud不会验证这个值，而会在响应消息中将其原样返回。使用说明：字段类型为字符串（最大长度1024）。 |
| SignType | 加密方式，如：SHA256、SHA512、HMAC-SHA256、HMAC-SHA512 |
| Authorization | 消息签名，详情请参阅消息签名部分。 |
签名方法
获取签名密钥
生成签名
1.构建待签名的字符串
在使用特定的签名算法之前，商家需要构建一个待签名的字符串。构建方法如下：
根据以下方法生成待签名的字符串。待签名的字符串包含6行。每一行包含一个参数，并以换行符结尾，最后一行除外。如果一行为空，则该行不会存在。换行符是 \n（ASCII 码值为 0x0A）。
2.Request URL: Request path + query string. Remember to remove the domain part of the URL.
3.DateTime in HTTP header: The time of the message being sent.
4.Signature key: The key assigned by EVO Cloud.
5.MsgID in HTTP header: The ID for the merchant to trace every API request.
6.HTTP body: All the data submitted in the HTTP body.
e9ce1bfb697c272fa75848ef0a7eb7c4f8019e5f46dc3141fe936830c32f397c
商户可以得到一个带有签名的HTTP请求信息，并可以将其发送至EVO Cloud：
验证从EVO Cloud接收的消息的签名
根据收 到的EVO Cloud请求，用和上述构建签名的字符串相同的字段构建一个字符串（同上述代码块）
用和EVO Cloud相同的方法计算签名