一、接口文檔

二、驗(yàn)簽說(shuō)明

QA會(huì)根據(jù)下面方式生成簽名，如果需要，請(qǐng)三方根據(jù)此方法驗(yàn)證簽名

QA在請(qǐng)求的接口路徑上會(huì)帶上 appId, accessKey, timestamp（時(shí)間戳參數(shù)），并且需要在header中加入簽名Authorization。

公共參數(shù)說(shuō)明

簽名生成規(guī)則：

• 使用請(qǐng)求參數(shù)構(gòu)造規(guī)范化的請(qǐng)求字符串（Canonicalized Query String）

• 按照參數(shù)名稱的字典順序?qū)φ?qǐng)求中所有的請(qǐng)求參數(shù)（包括文檔中描述的“公共請(qǐng)求參數(shù)”和給定了的請(qǐng)求接口的自定義參數(shù)）進(jìn)行排序。 注：當(dāng)使用GET方法提交請(qǐng)求時(shí)，這些參數(shù)就是請(qǐng)求URI中的參數(shù)部分（即URI中"?"之后由"&"連接的部分）

• 名稱和值要使用UTF-8字符集進(jìn)行URL編碼。

代碼示例

其中簽名的生成邏輯如下 java代碼示例：

String appId="tttt";
String accessKey = "xxxx";
String accessSecret ="yyyy";
String timeStamp = "1708235644862";

SortedMap<String, String> map = new TreeMap<>();
map.put("appId", appId);
map.put("accessKey", accessKey);
map.put("accessSecret",accessSecret );
map.put("timestamp", timeStamp);
//如果是get請(qǐng)求，還有其他的query參數(shù)，那么繼續(xù)加

String aa = getCanonicalQueryString(map);
System.out.println(aa);
String authorization = org.apache.commons.codec.digest.DigestUtils.md5Hex(aa);
System.out.println(authorization);

public static String getCanonicalQueryString(SortedMap<String, String> paramsMap) {
        StringBuilder queryString = new StringBuilder();
        boolean isFirstParameter = true;

        for (Map.Entry<String, String> entry : paramsMap.entrySet()) {
            String paramName = entry.getKey();
            String value = entry.getValue();

            if (!isFirstParameter) {
                queryString.append("&");
            } else {
                isFirstParameter = false;
            }
            queryString.append(paramName).append("=").append(value);
        }
        return queryString.toString();
}

示例如下：

curl --location -g --request POST 'http://{配置的獲取token的Url}?appId=aaa&accessKey=xxx&timestamp=yyy' \
--header 'Authorization: demosign'

三、異常碼說(shuō)明