Quick Audience：Quick Audience開放平台API

公用參數說明

使用者在訪問時，按照下面的方法對請求進行簽名處理：

• 使用請求參數構造正常化的請求字串（Canonicalized Query String）。

• 按照參數名稱的字典順序對請求中所有的請求參數（包括文檔中描述的“公用請求參數”和給定了的請求介面的自訂參數）進行排序。  註：當使用GET方法提交請求時，這些參數就是請求URI中的參數部分（即URI中"?"之後由"&"串連的部分）,產生簽名的參數中還需要accessSecret。

• 名稱和值要使用UTF-8字元集進行編碼。

• url的參數都需要使用urlEncode。

程式碼範例

其中籤名的產生邏輯如下 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請求，還有其他的query參數，那麼繼續加

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://{quick audience 公網網域名稱}/openapi/apipath/xxxx?appId=aaa&accessKey=xxx&timestamp=yyy' \
--header 'Authorization: demosign'

Quick Audience 會根據以上的參數進行驗簽，如果應用不存在，簽名不正確等都會攔截介面請求，其他的介面參數詳見具體的介面文檔。