认证授权

关于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