4.腾讯微博Android客户端开发——获取未受权的Request Token
原文:http://blog.****.net/coolszy/article/details/6547117
前面给大家介绍过腾讯微博API通过以下步骤来完成认证授权:
1.获取未授权的Request Token(temporary credentials)
2.请求用户授权Request Token
3.使用授权后的Request Token换取Access Token(token credentials)
本次给大家介绍如何获取未授权的Request Token。
在腾讯微博开放平台的API中介绍了获取Request Token的URL地址、所需要的参数以及返回内容。
获取request_token
URL:https://open.t.qq.com/cgi-bin/request_token
格式:xml,json
HTTPS请求方式:GET
是否需要鉴权:true
请求数限制:true
请求参数:
oauth_callback:回调URL 如果是桌面应用或手机应用没有回调URL,采用pin码方式,请填上 oauth_callback=null
oauth_consumer_key:你申请的appkey
oauth_nonce:随机串(32个字符长度)随机生成,只能使一次,与时间戳一起 防重放
oauth_signature:oauth请求签名 oauth请求的签名,根据oauth协议中算法生成basestring 后,用appsecret 对basestring 经hmac_sha1生成的签名串
oauth_signature_method:签名方法(HMAC-SHA1)
oauth_timestamp:时间戳 你的请求当前时间戳 (你的服务器时间你定要准确,不然请求会被拒绝掉)
oauth_version:oauth版本号(填 1.0 )
使用示例如下:
https://open.t.qq.com/cgi-bin/request_token?oauth_callback=http%3A%2F%2Fqunmgr.qq.com%2Foauthapi%2Fcallback.php&oauth_consumer_key=0aae7ba5c10d4b939694b0b3b9ffe8ac&oauth_nonce=b788149731e0ed75daa03a6e1e30427c&oauth_signature=zO5%2FgT%2FP6tbhBBZVuoyfjPwjdxY%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1288932298&oauth_version=1.0
返回结果:
oauth_token=a63f4a0e1242462fb8c11e53159ba294&oauth_token_secret=40ece707e064128e4fec692e3c09c692&oauth_callback_confirmed=true
返回结果说明:
oauth_token:返回的request_token
oauth_token_secret:返回的request_secret
oauth_callback_confirmed:回调确认
使用流程图表示则十分的简单:
其中URL地址和请求方式我们已经可以直接指定:
String url = "https://open.t.qq.com/cgi-bin/request_token"; String httpMethod = "GET";
请求所需的参数除了oauth_signature外我们都可以直接指定或者调用前面将结果的方法:
List params = new ArrayList(); String timestamp = generateTimeStamp(); String nonce = generateNonce(false); params.add(new Parameter("oauth_consumer_key", CONSUMER_KEY)); params.add(new Parameter("oauth_signature_method", SIGNATURE_METHOD)); params.add(new Parameter("oauth_timestamp", timestamp)); params.add(new Parameter("oauth_nonce", nonce)); params.add(new Parameter("oauth_callback", "null")); params.add(new Parameter("oauth_version", "1.0"));
同时发送请求和处理返回信息的方法在前面已给大家介绍,我们也可直接调用:
try { SyncHttp http = new SyncHttp(); String result = http.httpGet(url, params); } catch (Exception e) { e.printStackTrace(); }下面我们所需要处理的就是得到oauth_signature的值。
通过阅读帮助文档我们可得知oauth_signature是将请求源串以及密钥根据一定签名方法生成的签名值,用来提高传输过程参数的防篡改性。 签名值的生成共有3个步骤:构造源串,构造密钥,生成签名值。 Step 1.构造源串 第1步:将请求的URI路径进行URL编码。 第2步:将除“oauth_signature”外的所有参数按key进行字典升序排列。 第3步:将第2步中排序后的参数(key=value)用&拼接起来,并进行URL编码。 第4步:将HTTP请求方式(GET或者POST)以及第1步和第3步中的字符串用&拼接起来。 Step 2. 构造密钥 密钥由2部分内容用“&”拼接起来: oauth_consumer_secret & oauth_token_secret Step 3. 生成签名值 1. 使用HMAC-SHA1加密算法,将Step1中的到的源串以及Step2中得到的密钥进行加密。 2. 然后将加密后的字符串经过Base64编码,即得到oauth_signature签名参数的值。 代码如下:
String tokenSecret = "";
// App Key
String consumer_key = "dabd7b3bdf744acc9777a506c74c285e";
// App Secret
String consumer_secret = "04fb0ca42cb64ab06ef606b49579c9cb";
// 签名方法
String signature_method = "HMAC-SHA1";
// 请求URL
String url = "https://open.t.qq.com/cgi-bin/request_token";
// 请求方式
String httpMethod = "GET";
// 保存参数集合
List<Parameter> params = new ArrayList<Parameter>();
// 得到时间戳
String timestamp = generateTimeStamp();
// 单次值
String nonce = generateNonce();
// 添加参数
params.add(new Parameter("oauth_consumer_key", consumer_key));
params.add(new Parameter("oauth_signature_method", signature_method));
params.add(new Parameter("oauth_timestamp", timestamp));
params.add(new Parameter("oauth_nonce", nonce));
params.add(new Parameter("oauth_callback", "null"));
params.add(new Parameter("oauth_version", "1.0"));
// Step 1.构造源串:HTTP请求方式 & urlencode(uri) & urlencode(a=x&b=y&...)
StringBuilder baseStringBuilder = new StringBuilder();
baseStringBuilder.append(httpMethod);
baseStringBuilder.append("&");
baseStringBuilder.append(encode(url));
baseStringBuilder.append("&");
// 所有参数按key进行字典升序排列
Collections.sort(params);
for (Parameter param : params)
{
String name = encode(param.getName());
String value = encode(param.getValue());
baseStringBuilder.append(name);
baseStringBuilder.append("%3D"); // 字符 =
baseStringBuilder.append(value);
baseStringBuilder.append("%26"); // 字符 &
}
// 删除末尾的%26
baseStringBuilder.delete(baseStringBuilder.length() - 3, baseStringBuilder.length());
String baseString = baseStringBuilder.toString();
// Step 2. 构造密钥
String oauthKey = "";
if (null == tokenSecret || tokenSecret.equals(""))
{
oauthKey = encode(consumer_secret) + "&";
} else
{
oauthKey = encode(consumer_secret) + "&" + encode(tokenSecret);
}
// 生成签名值
byte[] encryptBytes = HMAC_SHA1.HmacSHA1Encrypt(baseString, oauthKey);
String signature = Base64.encode(encryptBytes);
params.add(new Parameter("oauth_signature", signature));
// 构造传递参数字符串
StringBuilder urlBuilder = new StringBuilder();
for (Parameter param : params)
{
urlBuilder.append(param.getName());
urlBuilder.append("=");
urlBuilder.append(param.getValue());
urlBuilder.append("&");
}
urlBuilder.deleteCharAt(urlBuilder.length() - 1);
String urlParams = urlBuilder.toString();
SyncHttp http = new SyncHttp();
String result = http.httpGet(url, urlParams);
System.out.println(result);
通过上面代码我们就能获取平台传递过来的信息,当然代码显得比较臃肿,课中中会分割在几个方法中。正常的返回结果为:
oauth_token=079ad6989409456a9878bf41ca8d2d7a&oauth_token_secret=b494075906b8846416735bf802ced89f&oauth_callback_confirmed=true
我们可以编写一个辅助方法获取每个返回参数的值,已供以后使用:
课程下载地址:http://u.115.com/folder/f6161918260
/** * 分割返回结果 * * @param response * 返回字符串 * @return */ public static Map<String, String> splitResponse(String response) { // 保存返回结果 Map<String, String> map = new HashMap<String, String>(); // 判断是否为空 if (!TextUtil.isEmpty(response)) { // 已“&”进行分割 String[] array = response.split("&"); if (array.length > 2) { String tokenStr = array[0]; // oauth_token=xxxxx String secretStr = array[1];// oauth_token_secret=xxxxxxx String[] token = tokenStr.split("="); if (token.length == 2) { map.put("oauth_token", token[1]); } String[] secret = secretStr.split("="); if (secret.length == 2) { map.put("oauth_token_secret", secret[1]); } } } return map; }文档下载地址:http://www.docin.com/p-220252513.html
源码下载地址:http://u.115.com/folder/f611696b2f6