分享到 :

get_oauth2_token

说明：
本文档描述了get_oauth2_token接口的使用说明。本接口可以将OAuth1.0的OAuth Token更新为OAuth2.0的Access Token。应用场景请参考网站升级OAuth2.0说明指南。关于升级OAuth的更多信息请参考《OAuth1.0升级到OAuth2.0指引》

1 接口说明

将指定用户的OAuth1.0的OAuth Token转换为OAuth2.0的Access Token。

1.1 URL

http://openapi.qzone.qq.com/user/get_oauth2_token

1.2 格式

JSON / XML

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数都必须是utf-8编码，且需进行URL 编码，编码时请遵守 RFC 1738。
请求参数请包含如下内容：

参数 是否必须 含义
oauth_consumer_key 必须 申请QQ登录成功后，分配给网站的appid。
oauth_token 必须 具有用户数据访问权限的OAuth 1.0的OAuth Token。
oauth_nonce 必须 随机字符串，int型。
oauth_timestamp 必须 unix时间戳（UTC时间从1970年1月1日00:00:00到当前时刻的秒数）。注意开发者的服务器时间与腾讯服务器时间相差不能超过5分钟。
oauth_version 必须 版本号，请固定使用1.0。
oauth_signature_method 必须 签名方法，请固定使用HMAC-SHA1。
oauth_signature 必须 签名值，用来提高传输过程参数的防篡改性。签名值的生成详见签名参数oauth_signature的说明。
openid 必须 与用户的QQ号一一对应的openid。
oauth_client_ip 可选 用户的IP地址。
format 可选 定义API返回的数据格式。取值说明：为xml时表示返回的格式是xml；为json时表示返回的格式是json。注意：json、xml为小写，否则将不识别。format不传或非xml，则返回json格式数据。。

 

1.5 返回参数说明

参数 说明
ret 错误码
msg 错误信息
openid 用户对应的openid
token 生成的oauth 2.0的access_token
expire access_token的过期时长,以秒为单位

 

1.6 请求示例

http://openapi.qzone.qq.com/user/get_oauth2_token?
oauth_consumer_key=100085&oauth_token=DKJFDKHNKVHHKDNX&oauth_nonce=34887553&
oauth_timestamp=1354181193&oauth_version=1.0&oauth_signature_method=HMAC-SHA1&oauth_signature=D890CA0909909C0888&
openid=HXMDKKKIKKNNVKKDXXiDVV&format=json

 

1.7 返回码说明

请参考公共返回码说明。

1.8 正确返回示例

{
"ret":0
"openid":"1704************************878C",
"token":"88VD*************KHHH",
"expire":"7776000"
}

 

1.9 错误返回示例

{
ret: 41002,
msg: "请求包错误"
}

 

 

返回顶部