Account/verify credentials
(→返回:) |
|||
(未显示6个用户的15个中间版本) | |||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=account/verify_credentials| | |
− | + | desc= | |
− | === | + | * 验证用户是否已经开通微博服务。 |
− | http:// | + | * 如果用户的新浪通行证身份验证成功,且用户已经开通微博则返回 http状态为 200,否则返回403错误。 |
+ | * 该接口除source以外,无其他参数。| | ||
+ | format=XML/JSON| | ||
+ | httpMethod=GET| | ||
+ | needAuth=true| | ||
+ | rateLimit=true| | ||
+ | params=| | ||
+ | getParam=| | ||
+ | postParam=| | ||
+ | result= | ||
+ | ===XML示例=== | ||
+ | <pre> | ||
+ | <?xml version="1.0" encoding="UTF-8"?> | ||
+ | <user> | ||
+ | <id>1642466141</id> | ||
+ | <screen_name>huchao</screen_name> | ||
+ | <name>huchao</name> | ||
+ | <province>11</province> | ||
+ | <city>8</city> | ||
+ | <location>北京 海淀区</location> | ||
+ | <description>Blogger,苹果迷,Google粉。</description> | ||
+ | <url>http://tuoniao.org</url> | ||
+ | <profile_image_url>http://tp2.sinaimg.cn/1642466141/50/1281523744</profile_image_url> | ||
+ | <domain>westy</domain> | ||
+ | <gender>m</gender> | ||
+ | <followers_count>65</followers_count> | ||
+ | <friends_count>59</friends_count> | ||
+ | <statuses_count>139</statuses_count> | ||
+ | <favourites_count>1</favourites_count> | ||
+ | <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at> | ||
+ | <following>false</following> | ||
+ | <verified>false</verified> | ||
+ | <allow_all_act_msg>false</allow_all_act_msg> | ||
+ | <geo_enabled>false</geo_enabled> | ||
+ | <status> | ||
+ | <created_at>Tue Sep 14 15:16:49 +0800 2010</created_at> | ||
+ | <id>2617110512</id> | ||
+ | <text>请叫我杂务小队长[奥特曼] 哔哔哔哔~~~~~~(呼唤动感超人的表情)</text> | ||
+ | <source> | ||
+ | <a href="http://t.sina.com.cn">新浪微博</a> | ||
+ | </source> | ||
+ | <favorited>false</favorited> | ||
+ | <truncated>false</truncated> | ||
+ | <geo/> | ||
+ | <in_reply_to_status_id/> | ||
+ | <in_reply_to_user_id/> | ||
+ | <in_reply_to_screen_name/> | ||
+ | </status> | ||
+ | </user> | ||
+ | </pre> | ||
+ | ===JSON示例=== | ||
+ | <pre> | ||
+ | { | ||
+ | "id":1642466141, | ||
+ | "screen_name":"huchao", | ||
+ | "name":"huchao", | ||
+ | "province":"11", | ||
+ | "city":"8", | ||
+ | "location":"北京 海淀区", | ||
+ | "description":"Blogger,苹果迷,Google粉。", | ||
+ | "url":"http://tuoniao.org", | ||
+ | "profile_image_url":"http://tp2.sinaimg.cn/1642466141/50/1281523744", | ||
+ | "domain":"westy", | ||
+ | "gender":"m", | ||
+ | "followers_count":65, | ||
+ | "friends_count":59, | ||
+ | "statuses_count":139, | ||
+ | "favourites_count":1, | ||
+ | "created_at":"Fri Aug 28 00:00:00 +0800 2009", | ||
+ | "following":false, | ||
+ | "allow_all_act_msg":false, | ||
+ | "geo_enabled":false, | ||
+ | "verified":false, | ||
+ | "status":{ | ||
+ | "created_at":"Tue Sep 14 15:16:49 +0800 2010", | ||
+ | "id":2617110512, | ||
+ | "text":"请叫我杂务小队长[奥特曼] 哔哔哔哔~~~~~~(呼唤动感超人的表情)", | ||
+ | "source":"<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>", | ||
+ | "favorited":false, | ||
+ | "truncated":false, | ||
+ | "in_reply_to_status_id":"", | ||
+ | "in_reply_to_user_id":"", | ||
+ | "in_reply_to_screen_name":"", | ||
+ | "geo":null | ||
+ | } | ||
+ | } | ||
+ | </pre>| | ||
+ | useAge= | ||
+ | * 若用户的新浪通行证身份验证成功,但未开通微博服务,则提示:40313:Error: invalid weibo user!。 | ||
+ | * 若用户的新浪通行证身份验证失败,则提示:40302:Error: auth faild!| | ||
+ | otherInfo= | ||
+ | ===Java示例=== | ||
+ | 请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br> | ||
+ | 代码示例如下: | ||
+ | package weibo4j.examples; | ||
− | + | import weibo4j.User; | |
− | + | import weibo4j.Weibo; | |
+ | import weibo4j.WeiboException; | ||
− | + | public class VerifyCredentials { | |
− | + | ||
− | + | public static void main(String[] args) { | |
− | + | System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY); | |
− | + | System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET); | |
− | + | try { | |
− | + | User user = getWeibo(true,args).verifyCredentials(); | |
− | + | System.out.println(user.toString()); | |
− | + | } catch (WeiboException e) { | |
− | + | e.printStackTrace(); | |
− | + | } | |
− | + | } | |
− | + | ||
− | + | private static Weibo getWeibo(boolean isOauth,String[] args) { | |
− | + | Weibo weibo = new Weibo(); | |
− | + | if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙 | |
− | + | weibo.setToken(args[0], args[1]); | |
− | + | }else {//用户登录方式 | |
− | + | weibo.setUserId(args[0]);//用户名/ID | |
− | + | weibo.setPassword(args[1]);//密码 | |
− | + | } | |
− | + | return weibo; | |
− | + | } | |
− | + | } | |
− | + | ===PHP示例=== | |
− | + | 请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK(支持OAuth验证之版本)<br> | |
− | + | 代码示例如下: | |
− | + | <pre> | |
− | + | //account/verify_credentials | |
− | + | $c = new WeiboClient( WB_AKEY , | |
− | + | WB_SKEY , | |
− | + | $_SESSION['last_key']['oauth_token'] , | |
− | + | $_SESSION['last_key']['oauth_token_secret'] ); | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | $msg = $c->verify_credentials(); |
− | + | if ($msg === false || $msg === null){ | |
+ | echo "Error occured"; | ||
+ | return false; | ||
+ | } | ||
+ | if (isset($msg['error_code']) && isset($msg['error'])){ | ||
+ | echo ('Error_code: '.$msg['error_code'].'; Error: '.$msg['error'] ); | ||
+ | return false; | ||
+ | } | ||
+ | if (isset($msg['name'])){ | ||
+ | echo($msg['name']); | ||
+ | } | ||
+ | </pre> | ||
+ | }} |
2010年12月7日 (二) 15:25的最后版本
目录 |
account/verify_credentials
- 验证用户是否已经开通微博服务。
- 如果用户的新浪通行证身份验证成功,且用户已经开通微博则返回 http状态为 200,否则返回403错误。
- 该接口除source以外,无其他参数。
URL
http://api.t.sina.com.cn/account/verify_credentials.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
注意事项
- 若用户的新浪通行证身份验证成功,但未开通微博服务,则提示:40313:Error: invalid weibo user!。
- 若用户的新浪通行证身份验证失败,则提示:40302:Error: auth faild!
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?> <user> <id>1642466141</id> <screen_name>huchao</screen_name> <name>huchao</name> <province>11</province> <city>8</city> <location>北京 海淀区</location> <description>Blogger,苹果迷,Google粉。</description> <url>http://tuoniao.org</url> <profile_image_url>http://tp2.sinaimg.cn/1642466141/50/1281523744</profile_image_url> <domain>westy</domain> <gender>m</gender> <followers_count>65</followers_count> <friends_count>59</friends_count> <statuses_count>139</statuses_count> <favourites_count>1</favourites_count> <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>false</geo_enabled> <status> <created_at>Tue Sep 14 15:16:49 +0800 2010</created_at> <id>2617110512</id> <text>请叫我杂务小队长[奥特曼] 哔哔哔哔~~~~~~(呼唤动感超人的表情)</text> <source> <a href="http://t.sina.com.cn">新浪微博</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> </status> </user>
JSON示例
{ "id":1642466141, "screen_name":"huchao", "name":"huchao", "province":"11", "city":"8", "location":"北京 海淀区", "description":"Blogger,苹果迷,Google粉。", "url":"http://tuoniao.org", "profile_image_url":"http://tp2.sinaimg.cn/1642466141/50/1281523744", "domain":"westy", "gender":"m", "followers_count":65, "friends_count":59, "statuses_count":139, "favourites_count":1, "created_at":"Fri Aug 28 00:00:00 +0800 2009", "following":false, "allow_all_act_msg":false, "geo_enabled":false, "verified":false, "status":{ "created_at":"Tue Sep 14 15:16:49 +0800 2010", "id":2617110512, "text":"请叫我杂务小队长[奥特曼] 哔哔哔哔~~~~~~(呼唤动感超人的表情)", "source":"<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null } }
其他
Java示例
请从 微博SDK开发包下载 下载Java SDK
代码示例如下:
package weibo4j.examples; import weibo4j.User; import weibo4j.Weibo; import weibo4j.WeiboException; public class VerifyCredentials { public static void main(String[] args) { System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY); System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET); try { User user = getWeibo(true,args).verifyCredentials(); System.out.println(user.toString()); } catch (WeiboException e) { e.printStackTrace(); } } private static Weibo getWeibo(boolean isOauth,String[] args) { Weibo weibo = new Weibo(); if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙 weibo.setToken(args[0], args[1]); }else {//用户登录方式 weibo.setUserId(args[0]);//用户名/ID weibo.setPassword(args[1]);//密码 } return weibo; } }
PHP示例
请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:
//account/verify_credentials $c = new WeiboClient( WB_AKEY , WB_SKEY , $_SESSION['last_key']['oauth_token'] , $_SESSION['last_key']['oauth_token_secret'] ); $msg = $c->verify_credentials(); if ($msg === false || $msg === null){ echo "Error occured"; return false; } if (isset($msg['error_code']) && isset($msg['error'])){ echo ('Error_code: '.$msg['error_code'].'; Error: '.$msg['error'] ); return false; } if (isset($msg['name'])){ echo($msg['name']); }
文档更新时间: 2010-12-07