認證授權

關於token、secret-key申請和修改，請在“個人中心 - 開放接口”頁面進行相關操作。

介面權限驗證

客戶端請求交易介面，header均要帶上Nonce,token,Signature參數。例如：

Python

$header[] = 'Nonce: 1534927978_ab43c';
$header[] = 'Token: 57ba172a6be125cca2f449826f9980ca';
$header[] = 'Signature: v490hupi0s0bckcp6ivb69p921';
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);

token：

用戶令牌，請在“個人中心 - 開放接口”查看。

Nonce：

隨機數，客戶端每次請求隨機生成字符。生成規則，時間戳_5位隨機字母或數字。如：1534927978_ab43c 注意：時間誤差不能超過60秒，相同隨機數只能被使用一次。

Signature：

簽名，使用$token,$secret_key,$nonce,$_POST,$_GET計算得出，服務端驗證簽名以確定請求是否來自用戶。

生成Signature的Python範例代碼：

Python

def sign(Nonce,data=dict()):

    tmp = list()
    tmp.append(TOKEN)
    tmp.append(SECRET)
    tmp.append(Nonce)
    for d,x in data.items():
        tmp.append(str(d) + "=" + str(x))

    return hashlib.sha1(''.join(sorted(tmp))).hexdigest()

產生Signature的PHP範例代碼：

PHP

private function signature($nonce)
{
    $token = TOKEN;
    $secret_key = SECRET-KEY;
    $tmpArr = array($api_key,$secret_key,$nonce);
    foreach($_GET as $k=>$v){
        $tmpArr[] = $k."=".$v;
    }
    foreach($_POST as $k=>$v){
        $tmpArr[] = $k."=".$v;
    }
    sort($tmpArr, SORT_STRING);
    $tmpStr = implode( $tmpArr );
    $signature = sha1( $tmpStr );
    return $signature;
}

生成Signature的Java範例代碼：

Java

List<String> paramArr = new ArrayList<>();
String token = "57ba172a6be125c";
String nonce = "1534927978_ab43c";
String secretKey = "ca2f449826f9980ca";
paramArr.add(token);
paramArr.add(secretKey);
paramArr.add(nonce);
//獲取所有請求參數
Enumeration enu=request.getParameterNames();
while(enu.hasMoreElements()){
    String paramKv = "";
    String paramName=(String)enu.nextElement();
    String paramVal=request.getParameter(paramName);
    paramKv += paramName;
    paramKv += "=";
    paramKv += paramVal;
    paramArr.add(paramKv);
}
Collections.sort(paramArr, new Comparator<String>() {
    @Override
    public int compare(String o1, String o2) {
        String str1=(String) o1;
        String str2=(String) o2;
        if (str1.compareToIgnoreCase(str2)<0){
            return -1;
        }
        return 1;
    }
});
//轉連接字符串
String paramStr = String.join("", paramArr);
String signature =DigestUtils.sha1Hex(paramStr);

範例：

Text Only

#假設：
$token = "57ba172a6be125c";
$secret_key = "ca2f449826f9980ca";
$nonce = "1534927978_ab43c";

#請求介面地址
/openApi/entrust/currentList
#提交參數
symbol = "BTC-USDT";
type = "1"

#排序後的字符串
1534927978_ab43c57ba172a6be125cca2f449826f9980casymbol=BTC-USDTtype=1

#sha1計算後：
$signature 為 731faa3d170bb746a767cea58ae563830594e1fe