为了接口调用的安全性，我们推荐你使用加密签名认证方式进行接口访问的认证，加密签名方式是一种替代单独API KEY的更安全的接口访问方式，它会对请求参数加密后得到的签名字串进行身份验证。虽然我们一直强制要求使用HTTPS加密的接口调用方式，已经足够确保你的安全性，但加密签名的方式则避免了API KEY由于各种原因泄露给第三方而导致的风险。

在接口请求中需要传递的参数

参数	描述	选择	示例值
username	用户ID，登录控制台可查看	必选	username=HE161025121212039
t	时间戳，秒级	必选	t=1477455132
sign	数字签名，签名算法	必选	sign=kNWMNt1fGAm2nIr54afBg

如果使用数字签名方式进行接口调用认证，则不需要再传递参数：key ( 此参数在签名算法中，只进行 sign 的计算，不得传递 )

示例

以获取实况天气为例

https://api.qweather.com/s6/weather/now?location=beijing&username=HE161025121212039&t=1477455132&sign=kNWMNt1fGAm2nIr54afBg

数字签名（sign）方式如下：

1. 将请求参数格式化为“key=value”格式，如“k1=v1”、“k2=v2”、“k3=v3”；
2. 去除请求参数中值为空的参数
3. 去除请求参数中参数为sign 的参数 ( 签名参数不参与签名算法 )
4. 将第3步剩余的键值对以字典序升序排列，并用 & 符号连接，如 a=1&b=2&m=3&w=4
5. 将第4步得到的字符串后拼接上API密钥, 假设密钥为 abc , 则 结果为: a=1&b=2&m=3&w=4abc
6. 将第5步得到的字符串进行MD5加密 ( 注 ：字符集为 UTF-8 )，得到签名结果
7. 将第6步得到的签名结果 作为参数添加至请求中，参数名为 sign, 即 sign=xxxxxxx

JAVA签名方法

/**
 * 和风天气签名生成算法-JAVA版本
 * @param HashMap<String,String> params 请求参数集，所有参数必须已转换为字符串类型
 * @param String secret 签名密钥（用户的认证key）
 * @return 签名
 * @throws IOException
 */
public static String getSignature(HashMap<String,String> params, String secret) throws IOException {
        // 先将参数以其参数名的字典序升序进行排序
        Map<String, String> sortedParams = new TreeMap<>(params);
        Set<Map.Entry<String, String>> entrys = sortedParams.entrySet();

        // 遍历排序后的字典，将所有参数按"key=value"格式拼接在一起

        StringBuilder baseString = new StringBuilder();
        for (Map.Entry<String, String> param : entrys) {
            //sign参数 和 空值参数 不加入算法
            if(param.getValue()!=null && !"".equals(param.getKey().trim()) && !"sign".equals(param.getKey().trim()) && !"key".equals(param.getKey().trim()) && !"".equals(param.getValue().trim())) {
                baseString.append(param.getKey().trim()).append("=").append(param.getValue().trim()).append("&");
            }
        }
        if(baseString.length() > 0 ) {
            baseString.deleteCharAt(baseString.length() - 1).append(secret);
        }

        // 使用MD5对待签名串求签
        try {
            MessageDigest md5 = MessageDigest.getInstance("MD5");
            byte[] bytes = md5.digest(baseString.toString().getBytes("UTF-8"));
            return new String(encodeHex(bytes));
        } catch (GeneralSecurityException ex) {
            throw new IOException(ex);
        }
    }
    
public static char[] encodeHex(byte[] data) {
        int    l        = data.length;
        char[] out      = new char[l << 1];
        int    i        = 0;
        char[] toDigits = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
        for ( int var5 = 0; i < l; ++i ) {
            out[var5++] = toDigits[(240 & data[i]) >>> 4];
            out[var5++] = toDigits[15 & data[i]];
        }
        return out;
    }

PHP签名方法

/**
  * 和风天气签名生成算法-PHP版本
  * @param array $params API调用的请求参数集合的关联数组（全部需要传递的参数组成的数组），不包含sign参数
  * @param $secret 用户的认证 key
  * @return string 返回参数签名值
  */
 function getSignature($params, $secret) {
    $str = '';  //待签名字符串
    //先将参数以其参数名的字典序升序进行排序
    array_filter($params);
    unset($params['sign']);
    unset($params['key']);
    ksort($params);
    //遍历排序后的参数数组中的每一个key/value对
    foreach($params as $k => $v){
        $str .= $k . '=' . $v . '&';
    }
    $str = substr($str,0,strlen($str)-1);
    //将签名密钥拼接到签名字符串最后面
    $str .= $secret;
    //通过md5算法为签名字符串生成一个md5签名，该签名就是我们要追加的sign参数值
    return md5($str);
 }

Python签名方法

import sys,urllib,urllib2,hashlib,base64,time,binascii

# 和风天气签名生成算法-Python版本
# params API调用的请求参数集合的关联数组（全部需要传递的参数组成的数组），不包含sign参数
# secret 用户的认证 key
# return string 返回参数签名值
def helloWorld(params, secret):
    canstring = ''
    #先将参数以其参数名的字典序升序进行排序
    params = sorted(params.items(), key=lambda item:item[0])
    #遍历排序后的参数数组中的每一个key/value对
    for k,v in params:
        if( k != 'sign' and k != 'key' and v != '') :
         canstring +=  k + '=' + v + '&'
    canstring = canstring[:-1]
    canstring += secret
    return hashlib.md5(canstring).hexdigest()