微博API使用说明书
新浪微博API
新浪微博API新浪微博API(android版)============================本版本在java版的基础上修改,使其可以在android sdk上使用.新增加了android的OAuth登陆认证及获取好友微博的实现样例.常用接口实例:(使用前先修改 Weibo.java 中public static final String CONSUMER_KEY = "";public static final String CONSUMER_SECRET = "";填写成实际申请的 CONSUMER_KEY 及 CONSUMER_SECRET)1、获取最新公共微博列表参考:weibo4j.examples.GetTimelines 中的getPublicTimeline()部分2、发表微博参考:weibo4j.examples.Update 中的updateStatus(...)部分3、发表评论参考:weibo4j.examples.Update 中的updateComment(...)部分4、删除评论参考:weibo4j.examples.Update 中的destroyComment(...)部分5、发送私人消息参考:weibo4j.examples.DirectMessage 类6、发表带图片的微博参考:weibo4j.examples.OAuthUploadByFile 中的uploadStatus(status,file)部分7、更新用户头像参考:weibo4j.examples.OAuthUpdateProfile类8、OAuth登陆认证参考: andriodexamples 的demo.====================================== ======================================= 其他接口在weibo4j.Weibo类中定义,调用方式请参考weibo4j.examples,下面是完整的接口列表:获取下行数据集(timeline)接口方法名:statuses/public_timeline 最新公共微博方法名:getPublicTimelinestatuses/friends_timeline 最新关注人微博(别名: statuses/home_timeline) 方法名:getFriendsTimeline statuses/user_timeline 用户发表微博列表方法名:getUserTimeline(String id, Paging paging)statuses/mentions 最新 @用户的方法名: getMentions()statuses/comments 单条评论列表(按微博) 方法名:getComments()微博访问接口statuses/show 获取单条方法名:showStatus(long id)statuses/update 发表微博方法名:updateStatus(String status) statuses/upload 发表微博及图片方法名:uploadStatus(String status,File file)statuses/destroy 删除方法名: destroyStatus(long statusId)statuses/comment 评论方法名:destroyComment(long commentId)statuses/comment_destroy 删除评论方法名:destroyComment私信接口direct_messages 我的私信列表方法名:getDirectMessages() 分页 getDirectMessages(Paging paging)direct_messages/sent 我发送的私信列表方法名:getSentDirectMessages()direct_messages/new 发送私信方法名:sendDirectMessage(String id,String text)direct_messages/destroy 删除一条私信方法名:destroyDirectMessage(int id)关注接口friendships/create 关注某用户方法名:createFriendship(String id)或 createFriendship(String id, boolean follow)friendships/destroy 取消关注方法名:destroyFriendship(String id)friendships/exists 是否关注某用户方法名:existsFriendship(String userA, String userB)friends/ids关注列表方法名: getFriendsIDs(long cursor)followers/ids 粉丝列表方法名:getFollowersIDs(long cursor) 账号接口account/verify_credentials 验证身份是否合法方法名:verifyCredentials()account/rate_limit_status 查看当前频率限制方法名:rateLimitStatus()account/update_profile_image 更改头像方法名:updateProfileImage(File image)account/update_profile 更改资料方法名:User updateProfile(String name, String email, String url, String location, String description)收藏接口favorites 收藏列表方法名:getFavorites()favorites/create 添加收藏方法名:createFavorite(long id)favorites/destroy 删除收藏方法名:destroyFavorite(long id)。
新浪微博开放平台
简介新浪微博开放平台的体系参考了Twitter,两者非常类似,包括接口、参数的定义,请求方式等等,如果熟悉Twitter的API,基本可以同样的适用到新浪微博开放平台上,同时此文档技术部分的信息也可以同样适用于Twitter。
新浪微博开放平台的网站为/,目前只部分页面对匿名用户开放。
新浪微博开放平台的官方微博为/openapi,可以在此申请API试用权限。
注册在开放平台登录后可以看到的界面如下所示:可以选择创建一个应用,需要设置应用名称、应用地址等。
创建后可以在“我的应用”菜单里看到该应用和使用用户数,系统会为此应用分配一个APP KEY和APP SECRET,这两个字串非常重要,将会在以后认证或者信息交互时用到。
某应用的详细信息页面应用分为多个授权级别,分别为普通授权、中级授权、高级授权、合作伙伴授权,可以在/wiki/index.php/Rate-limiting这里看到详细的权限信息。
使用合作伙伴授权是没有请求限制的,而普通授权可能一不小心就会Server Limit了。
认证开放平台有两种认证方式,一种是Basic Auth,一种是OAuth。
1、Basic Auth(HTTP Auth)Basic Auth简单点说明就是每次请求API时都提供用户的username和passw ord。
例如:“curl -u user:password -d "source=10001&status=api test" . cn/update.xml”。
这种方式优点和缺点都很明显。
优点:◆使用非常简单,◆开发和调试工作简单,◆没有复杂的页面跳转逻辑和交互过程;◆更利于发起方控制;缺点:◆安全性低,每次都需要传递用户名和密码,用户名和密码很大程度上存在被监听盗取的可能;◆同时应用本地还需要保存用户名和密码,在应用本身的安全性来说,也存在很大问题;◆开放平台服务商出于自身安全性的考虑(第三方可以得到该服务商用户的账号密码,对于服务商来说是一种安全隐患),未来也会限制此认证方式(Twitter就计划在6月份停止Basic Auth的支持)◆用户如果更改了用户名和密码,还需要重新进行密码校验的过程。
腾讯微博和Linkedin接口使用总结
1.腾讯微博使用:(1)在腾讯微博开放平台(/development)申请应用。
【注意点】[1]申请站内应用;[2]基本信息中的应用名称将在你使用时显示,故不可随意写;[3]基本信息中的实际应用地址必须是使用该应用过的实际网址,且可以直接点击进入。
(2)搭建环境。
<script src="/app/openjs/openjs.js#debug=yes"type="text/javascript"></script>(3)获取授权。
function Oauth(){//初始化授权页面T.init({appkey: 801188535, //申请应用的Appkeycallbackurl: 'http://127.0.0.1:1843/Home/Send', //回调网址,必须与应用中的实际应用地址相同samewindow: true //默认false,弹出框;若为true,则跳出一个新页面});//登录授权T.login(function (loginStatus) {showDetails(loginStatus); //授权成功的回调函数,loginStatus为登录成功后的用户信息,包括access_token },function (error) { //授权失败,做出的反应alert(' ');});}(4)调用接口。
T.api("/user/info") //接口名称.success(function (response){alert(response.nick); //调用接口成功后的回调函数,response为接口返回值,具体参见各接口}).error(function (code, message) { //调用接口失败,做出的处理;alert(message);});(5)登出用户,清除用户授权信息。
新浪微博API开发教程(一)-体验篇
现在新浪微博开放平台()非常火啊,所以。
。
,你懂的! 首先,想要开发新浪微博 API,你就必须获取 APP KEY 和 APP SECRET,我毫不犹豫的就用 新浪微博账号登录了开放平台,创建了自己的应用如下:然后又去下载了新浪微博开发平台基于 PHP 的 SDK 包(包含 demo 程序) ,这个下载地址 是: /p/libweibo/downloads/detail?name=weibo-oauth-classwith-image-avatar-06-29.zip OK,一切完毕,首先解压 SDK 包后里面有如下5个文件,一一介绍下: config.php 是配置文件index.php 进入到新浪微博的验证授权页面 同意授权之后 回到 callback.php 页面 weibolist.php 微博发表以及列表页 weibooauth.php 类文件, 装着许多类和函数, 开发中需要用到的! 后期 php 教程再说! ( ) 开始进行测试: 首先打开 config.php 文件,填上 APP KEY 和 APP SECRET,否则授权失败!打开浏览器:http://localhost/zend/SinaApi/出现:Use Oauth to login 点击进入,居然报错(如下) ,真是打击我的信心啊!sorry, that page doesn’t exist!通过查阅资料发现是这个原因,index.php 的第16、17行: $_SERVER['SCRIPT_URI'] 错误,貌似 php 里面也没 SCRIPT_URI 这参数吧,好吧,将第 16、17行,的 $_SERVER['SCRIPT_URI'] 改为本地地址:'http://localhost/zend/SinaApi' 果然,点击进入后,显示授权成功,授权完成,进入你的微博列表页面 weobolist.php,有点小兴奋了!需要注意几点: 1.官方 SDK 中,有<?=?>段标签模式,这是 php 默认不开启的,你可以 改成<?php echo ?>2.注意编码问题,官方是用 UTF-8编码的!转 载 请 声 明 : 文 章 转 载 自 : PHP 点 点 通 , 原 文 地 址 :/php/sina-api.html。
新浪微博开放平台api
用java开发新浪微博的API首先先注册新浪微博(如果有了的可以直接登录)在进入新浪微博的开放平台下载SDK 下载最新的SDK /wiki/SDK然后把SDK 导入到MyEclipse 里接着在进入新浪微博的开放平台点击我要成为开发者注册1.填写开发者资料2.验证邮箱3.创建应用/添加网站点击创建应用有5种应用选择站内应用然后把信息填完点击创建成功后在应用基本信息里就会显示App Key 和App Secret再接着往下看会看到站内应用地址和应用实际地址记住填写的内容回到MyEclipse在src下面找到config.properties填写client_ID =App Keyclient_SERCRET =App Secretredirect_URI =应用实际地址(也可以不写我就没有写)保存接着就是写一条获取微博的前20条信息在examples 下的weibo4j.examples.oauth2下的OAuth4Code下直接运行(如果报错把改成),就会出现授权页面,登录,登录成功后,点击授权查看网址后面有个code=XXXX把code=后面的XXXX复制到MyEclipse 的控制台中的https:///oauth2/authorize?client_id=1682103644&redir ect_uri=/boyaboya&response_type=code&state=& scope=Hit enter when it's done.[Enter]:后面然后按回车就会输出一大堆消息直接跳到最后会看到记住"access_token" 后面的值就是是我们要用到的值了记录下来下面开始获取微博最新的前20条信息喽weibo4j.examples.timeline 下的 GetPublicTimeline 类中代码如下package weibo4j.examples.timeline;import java.util.List;import weibo4j.Timeline;import weibo4j.Weibo;import weibo4j.examples.oauth2.Log;import weibo4j.model.PostParameter;import weibo4j.model.Status;import weibo4j.model.StatusWapper;import weibo4j.model.WeiboException;import weibo4j.util.WeiboConfig;public class GetPublicTimeline {/***获取最新更新的公共微博消息*@param args*/public static void main(String[] args) {String access_token = "2.00zd8kXCwzvppB3d7bd9a1722AINVD";Weibo weibo=new Weibo();weibo.setToken(access_token);Timeline tm = new Timeline();tm.client.setToken(access_token);try {StatusWapper status = tm.getPublicTimeline();for(Status s : status.getStatuses()){Log.logInfo(s.toString());}System.out.println(status.getNextCursor());System.out.println(status.getPreviousCursor());System.out.println(status.getTotalNumber());System.out.println(status.getHasvisible());} catch (WeiboException e) {e.printStackTrace();}}}写完直接运行在控制台中就会直接输出最新的的前20条微博了。
移动微博API
API目录[隐藏]1 REST规范接口2 接口授权说明o 2.1 后台访问权限o 2.2 特殊参数权限3 API 函数o 3.1 登录验证(auth)o 3.2 用户(users)o 3.3 好友(friends)o 3.4 通知(notifications)o 3.5 短信(sms)o 3.6 内容管理(content)o 3.7 支付平台(pay)o 3.8 圈子(groups)o 3.9 话题(topic)o 3.10 相册(photos)o 3.11 移动微博(说客)(italk)o 3.12 收听关系(contact)o 3.13 邮件(mail)o 3.14 connecto 3.15 移动通讯录的联系人(address_list)o 3.16 网盘(netdisk)o 3.17 搜索(search)o 3.18 私聊(dialog)o 3.19 收藏(favorite)o 3.20 外部链接links本文是关于MIOP API的描述文档。
通过这些API,您的应用程序可以获得移动微博平台上开放的数据和业务功能。
移动微博开放平台提供访问API的多语言客户端SDK,通过SDK,能够帮助开发者访问API的接口。
安全要求,app_secret 密钥只能保存在第三方服务器侧以及开放平台服务器侧,接口访问流程是REST规范接口API是采用REST基础的接口规范。
所有的API都是通过HTTP的POST向移动微博开放平台API REST Server(/restserver.php)发送请求来实现的。
几乎所有的计算机语言都可以通过HTTP协议同REST服务器通信。
为了保证第三方与移动微博开放平台之间通讯的安全性,移动微博开放平台对Rest的访问方式进行REST签名认证。
移动微博开放平台提供的开发包,采用了REST规范封装了所有API。
您也可以根据REST 签名认证开发自己的开发包。
移动微博开放平台开发包下载地址:【开发包下载地址】接口授权说明正常的访问是必须拿到当前用户的session_key,然后实例化Miop对象,调用开放平台接口。
api使用条款
api使用条款API使用条款一、引言在使用API之前,请仔细阅读并理解本使用条款。
通过使用API,您表示同意遵守以下条款及条件。
如果您不同意这些条款,请不要使用API。
二、API许可1. 本API由我们授予您个人或组织使用,并仅限于您合法使用的范围内。
2. 您不得将API许可转让给第三方,除非经过我们书面许可。
三、API使用限制1. 您不得将API用于非法目的,包括但不限于侵犯他人权益、传播恶意软件等行为。
2. 您不得通过API访问、收集或存储任何个人信息,除非获得相关用户的明确授权。
3. 您不得对API进行任何形式的修改、篡改或逆向工程。
4. 您不得以任何方式干扰、破坏或损害API的正常运行。
四、责任限制1. 我们对于因您使用API而导致的任何直接、间接、附带、特殊、衍生或惩罚性损害概不负责。
2. 我们不保证API的功能和性能始终符合您的需求,也不对API的可用性做任何承诺。
五、知识产权1. API及其相关文档等知识产权归我们所有。
2. 您在使用API时,不得侵犯我们的知识产权,包括但不限于复制、修改、传播API或与API相关的任何内容。
六、结束使用如果您违反本使用条款,我们有权立即终止您对API的使用权限。
同时,您应承担因违反条款而产生的任何责任。
七、其他条款1. 本使用条款的解释、适用与执行均适用中华人民共和国法律。
2. 如果本使用条款中的任何条款被认定为无效或不可执行,不影响其他条款的有效性和可执行性。
八、声明本使用条款的最终解释权归我们所有。
如有任何疑问或投诉,请联系我们的客服人员。
以上就是API使用条款的内容。
我们希望您在使用API时能够遵守这些条款,以保证您和他人的权益。
如果您有任何疑问或意见,请及时与我们联系。
感谢您的配合与支持!。
NET调用新浪微博开放平台发送微博
.NET调用新浪微博开放平台发送微博1. 首先我们要获取一个App Key,在新浪微博开放平台的“我的应用”中创建一个应用,就会生成App Key,假设是123456。
2. 在新浪微博API文档中找到你想调用的API,这里我们假定调用发表微博的API-statuses/update,url是/statuses/update.json,POST 的参数:source=appkey&status=微博内容。
其中appkey就是之前获取的App Key。
3. 准备数据1) 准备用户验证数据:(用来登录并授权)string username = "t@";string password = "";string usernamePassword = username + ":" + password;username是你的微博登录用户名,password是你的博客密码。
2) 准备调用的URL及需要POST的数据:string url = "/statuses/update.json";string news_title = "美丽景色";int news_id = 62747;string t_news = string.Format("{0},/n/{1}/", news_title, news_id);string data = "source=123456&status=" + System.Web.HttpUtility.UrlE ncode(t_news);4. 准备用于发起请求的HttpWebRequest对象:.WebRequest webRequest = .WebRequest.Create(ur l);.HttpWebRequest httpRequest = webRequest as .H ttpWebRequest;5. 准备用于用户验证的凭据:.CredentialCache myCache = new .CredentialCach e();myCache.Add(new Uri(url), "Basic", new workCredential(username, password));httpRequest.Credentials = myCache;httpRequest.Headers.Add("Authorization", "Basic " +Convert.ToBase64String(new System.Text.ASCIIEncoding().GetBytes(usern amePassword)));6. 发起POST请求:httpRequest.Method = "POST";httpRequest.ContentType = "application/x-www-form-urlencoded";System.Text.Encoding encoding = System.Text.Encoding.ASCII;byte[] bytesToPost = encoding.GetBytes(data);httpRequest.ContentLength = bytesToPost.Length;System.IO.Stream requestStream = httpRequest.GetRequestStream(); requestStream.Write(bytesToPost, 0, bytesToPost.Length);requestStream.Close();上述代码成功执行后,就会把内容发到了你的微博上了。
Xweibo微博API接口说明
Xweibo微博API接口说明Xweibo2011年6月目录目录1接口概述 (1)2API调用说明 (1)2.1参数说明: (1)2.2Api访问方式说明: (1)3API返回值说明 (2)3.1返回格式:json (2)3.2返回结构:{"rst":返回结果,"errno":结果代码,"err":"错误提示信息"} (2)4错误代码 (2)4.1参数检查错误代码: (2)4.2平台级别错误代码: (3)5接口介绍 (3)5.1微博访问接口 (3)5.1.1action.update:发布一条微博消息 (3)5.1.2action.destroy:删除一条微博信息 (4)5.1.3action.repost:转发一条微博信息 (5)ment:对一条微博信息进行评论 (6)ment.destroy:删除微博评论 (6)5.1.6action.reply:回复微博评论消息 (7)5.2关注接口 (9)5.2.1action.createFriendship:关注某用户 (9)5.2.2action.deleteFriendship:取消关注或移除粉丝 (10)5.2.3action.friendship:查看某人是否为指定用户的粉丝 (10)5.3收藏接口 (11)5.3.1action.createFavorite:添加收藏 (11)5.3.2action.deleteFavorite:删除收藏 (11)5.4账号接口 (12)5.4.1action.updateProfileImage:更改头像 (12)5.4.2action.saveProfile:更改个人资料 (12)5.5获取下行数据集(Timeline)接口 (13)5.5.1action.unread:获取当前用户未读消息数 (13)5.5.2action.getComments:获取指定微博的评论列表 (13)5.5.3action.getCounts:批量获取评论数和转发数 (116)5.5.4action.clearTip:未读消息数清零接口 (116)5.6私信接口 (16)5.6.1action.sendDirectMessage:发送私信 (16)5.6.2action.deleteDirectMessage:删除私信 (16)5.7用户接口 (17)5.7.1action.createBlocks:加入黑名单 (17)5.7.2action.deleteBlocks:删除黑名单 (17)5.7.3action.createTags:添加标签 (18)5.7.4action.deleteTags:删除标签 (18)5.8其它接口 (19)5.8.1action.setting:tip个人设置 (19)5.8.2action.sinaurl:解析短链接 (19)5.8.4action.saveNotice:更新提醒设置和tip显示方式 (21)Xweibo微博API接口说明1 接口概述Xweibo不仅提供了快速、低成本架设微博的解决方案,还提供了让第三方调用的API接口。
Android平台微博SDK说明文档
微博Android平台SDK文档北京新潮讯捷信息技术有限公司编号:WEIBO_ANDROID_SDK版本:WEIBO_ANDROID_SDK V2.0.0修订记录目录微博Android平台SDK文档 (1)概述 (3)主要类说明: (3)主要接口说明 (3)1.获取Weibo对象 (3)2.获取Oauth2AccessToken对象 (5)3.分享到微博 (5)4.SSO支持 (6)实例分析 (6)1.通过Oauth2.0授权获得AccessToken (7)2.发送微博 (8)SSO介绍 (10)1.SSO功能使用方式 (10)2.SSO授权功能介绍 (10)3.SSO授权优势 (10)4.SSO授权流程示例 (10)SDK使用说明 (12)1.使用weibo.sdk.android(不包含sso功能) (12)2.使用weibo.sdk.android.sso (15)3.SDK使用及修改必须遵守微博开发者协议,以及开源软件协议。
(18)概述微博Android平台SDK为第三方微博应用提供了文档易用的微博API调用服务,使第三方客户端无需了解复杂的验证,API调用过程。
并可以实现分享到微博的功能,可以分享文字,或者多媒体信息到内置的分享页面,并发送到微博。
主要类说明:1.Weibo: 微博API 接口类,对外提供weiboapi的调用,包括登录,API调用,微博分享等功能。
2.Oauth2AccessToken:封装了“access_token”,“expires_in”,"refresh_token",并提供了他们的管理功能3.Utility:工具类,提供了url 的encode,decode方法。
4.AsyncWeiboRunner:微博api异步执行类,封装了回调接口,通过创建线程来调用Weibo中的接口方法。
5.HttpManager: 负责与服务器进行通讯的类,封装了GET、POST请求方式,并对外提供图片上传等功能6.WeiboAPI: 该类及其子类封装了新浪微博对外提供的api接口方法。
新浪微博开发者平台应用申请及配置说明
第一章常见问题说明在本项目微博开发文档中大家使用新浪微博官方提供的WeiboSDKDemo为大家演示项目基本环境的搭建,后面的开发也是在此基础上进行开发,目的是方便大家学习和理解项目结构、新浪微博的认证授权及新浪微博API调用。
WeiboSDKDemo使用的appkey、授权回调地址和debug.keystore均是新浪微博官提供的,并且WeiboSDKDemo的包名不能更改,在大家熟悉项目结构之后,也可以自己在新浪微博开放平台上申请开发者账号,并且创建自己的应用,就不必使用新浪微博官方提供的了,创建过程可以参考第二章和第三章。
在使用WeiboSDKDemo注意事项:1.使用WeiboSDKDemo时不能更改WeiboSDKDemo中所用的包名(com.sina.weibo.sdk.demo),在src根目录下的Constants.java文件中提供了AppKey ,一定要使用这个appKey,否则将会导致新浪官方的授权认证服务器上的签名认证失败。
2.一定要使用Demo中提供的debug.keystore3.MD5工具是根据keystore来生成签名的,不同的keystore生成的签名是不一样的。
此Demo的签名是用官网提供的keystore生成的,若要顺利运行Demo程序,需要进行设置或是替换keystore,两种方法可以选择其中一种进行操作:方法一:替换keystore,把Android默认的debug.keystore(在C:\Users\xxxx\.android目录下)替换成官方在Hithub上提供的debug.keystore。
方法二:在Eclipse中设置工程keystore,在Eclipse中点击“Windows -> Preferences -> Android -> Build”,在Custom debug keystore 中选择Demo中的debug.keystore,点击Apply -> OK,Demo即可正常运行。
第三方登录及分享帮助文档
第三方登录及分享帮助文档修订日期1.概述1.1.文档说明本文档定义了新浪微博第三登录,QQ第三方登录,新浪微博分享的使用说明、体系结构、API 接口,所有接口必需在联网状态下才能正常使用。
其适用的读者为android软件工程师,通过阅读本文档,读者可以掌握如何使用第三方登录及微博分享功能。
2.使用说明2.1.开发说明1. 使用第三方服务,需要经过第三平台的授权,请到分别到 和/manage/login注册成为新浪及QQ互联的开发者,并为所开发的软件申请appid;2. 如果开发者申请了appid,只需要在Demo中的com.oauthTest.utils.ConfigUtil.java中配置appid和appSecret即可实现本文档描述的功能。
如果需要详细的了解这一切的原理步骤,请参考程序Demo和以下文档。
2.2.支持平台1. 支持Android 1.6 及以上版本系统;2.3.类属性介绍1.com.oauthTest.utils.ConfigUtil.java(配置信息)2. com.oauthTest.servicemodel.SinaTokenSM(新浪令牌信息)3. com.oauthTest.servicemodel.SinaTokenSM (QQ令牌信息)4. com.oauthTest.servicemodel.GeoSM(地理信息)5. erSM(用户信息)6.com.oauthTest.servicemodel.SinaWeiBoSM(新浪微博信息)2.4.原理详解2.4.1.新浪第三方登录第一步:首先使用WebView打开授权界面。
第二步:进入授权界面后,用户在授权界面输入新浪账号和密码后点击授权或登录获取此用户的授权,授权获取成功后。
返回code和state参数。
第三步:然后通过访问指定地址请求token(令牌)信息。
返回令牌信息后。
令牌信息中有一个uid 的字段,这个字段相对于授权的应用是唯一的,也就是说它下次对本应用授权后,返回的uid值还是一模一样的,所以这时我们只要保存这个UID即可。
快速学习和使用新浪微博API开发WEB应用
新浪微博API,看起来像一个高深莫测的东西,的确,这也不是一个很简单是的东西。
新浪微博API,当我第一次接触它的时候真的不知所措,感觉得很难入手,而且中间经常出现错误,一般是漏了某些参数造成,就需要浪费大量的时间去调试,在这里要感谢一下我的朋友Randy的帮忙和指导!好了,废话少说,现在直接告诉大家一些我的心得,快速学习和使用新浪API。
第一步:申请新浪微博账号,登陆后在这里/apps创建一个应用,里面的信息暂时可以乱填写(应用开发完成了再回来修改)。
创建后系统会分配一个App Key和App Secret,这两个是验证开发者的身份,必不可少(在下一步下载的SDK 源码里会有作者的,应该还可以正常使用,建议替换成你的。
)第二步:下载SDK源码,我是使用C#的,所以下载的是/wiki/index.php/SDK#C.23选择第二个或者/p/opensinaapi/。
下载完解压后,就可以直接使用VS打开。
第三步:SDK源码主要文件oAuthBase.cs 、oAuthSina.cs、 ISinaApiService.cs 、SinaApiService.cs四个文件。
上一步提到的两个KEY就在oAuthSina.cs文件第31行,直接替换即可。
那再看SinaApiService.cs文件,第63行user_timeline方法。
view plaincopy to clipboardprint?1./*用户发表微薄列表*/2.public string user_timeline(string userid, string passwd, string format)3.{4. oAuthSina _oauth = new oAuthSina();5. if (oAuth(userid, passwd, _oauth))6. {7. string url = "/statuses/user_timeline." +format;8. return _oauth.oAuthWebRequest(oAuthSina.Method.GET, url, String.Empty);9. }10. else11. return null;12.}1. /*用户发表微薄列表*/2.public string user_timeline(oAuthSina oauth, string format)3.{4. string url = "/statuses/user_timeline." + format;5. return oauth.oAuthWebRequest(oAuthSina.Method.GET, url, String.Empty);6.}1.<%2. oAuthSina oauth = new oAuthSina();3. string authLink = oauth.AuthorizationSinaGet() + "&oauth_callback=http://localhost:2122/SinaApiCallBack.ashx";4. Session["Sina_oAuth"] = oauth; //保存到Session以便于后台调用5.%>6.<div>7. <a href="<%=authLink %>">登陆到新浪微博</a>8.</div>1.context.Response.ContentType = "text/plain";2.context.Response.Write("Hello World");3.string oauth_token = context.Request["oauth_token"];4.string oauth_verifier = context.Request["oauth_verifier"];5.if (context.Session["Sina_oAuth"] != null)6.{7. oAuthSina oauth = (oAuthSina)context.Session["Sina_oAuth"]; //从前台session保存下来的8. oauth.Verifier = oauth_verifier;9. oauth.Token = oauth_token;10. oauth.AccessTokenGet(oauth_token);11. SinaApiService sina = new SinaApiService();12. string user = er_timeline(oauth, "xml"); //以上几行代码暂时不需要知道是什么,但必不可少,照写就行了13. context.Response.Write(user); //输出新浪API返回的XML文档内容14.}有什么问题或建议大家可以一起讨论和研究。
第三方登录及分享帮助文档
第三方登录及分享帮助文档修订日期1.概述1.1.文档说明本文档定义了新浪微博第三登录,QQ第三方登录,新浪微博分享的使用说明、体系结构、API 接口,所有接口必需在联网状态下才能正常使用。
其适用的读者为android软件工程师,通过阅读本文档,读者可以掌握如何使用第三方登录及微博分享功能。
2.使用说明2.1.开发说明1. 使用第三方服务,需要经过第三平台的授权,请到分别到和注册成为新浪及QQ互联的开发者,并为所开发的软件申请appid;2. 如果开发者申请了appid,只需要在Demo中的,请参考程序Demo和以下文档。
2.2.支持平台1. 支持Android 1.6及以上版本系统;2.3.类属性介绍1.2.3. (QQ令牌信息)4.5.6.2.4.原理详解第一步:首先使用WebView打开授权界面。
第二步:进入授权界面后,用户在授权界面输入新浪账号和密码后点击授权或登录获取此用户的授权,授权获取成功后。
返回code和state参数。
第三步:然后通过访问指定地址请求token(令牌)信息。
返回令牌信息后。
令牌信息中有一个uid的字段,这个字段相对于授权的应用是唯一的,也就是说它下次对本应用授权后,返回的uid值还是一模一样的,所以这时我们只要保存这个UID即可。
通过这个UID来关联自己的本地应用的用户信息,这样第三方登录就实现了。
详细介绍:1.请求用户授权:2.通过code换取token(令牌)信息:2.4.2.QQ第三方登录第一步:首先使用WebView打开授权界面,进入授权界面,第二步:用户在授权界面输入QQ账号和密码后点击授权或登录获取此用户的授权,授权成功后就会立刻返回token(令牌)信息,这相对于新浪少了一步。
详细介绍:获取token(令牌)信息:通过令牌信息中的access_token字段,发布微博。
发布微博时,首先要判断access_token是否存在或者过期?如果是,则弹出重新获取应用授权的界面。
新浪微博的API
1,开发流程技术规范与指南目录隐藏∙ 1 概述∙ 2 开发流程o 2.1 申请APPKEYo 2.2 应用创建及发布流程∙ 3 开发指南o 3.1 SDK简介及作用o 3.2 如何通过授权访问数据3.2.1 OAUTH认证o 3.3 如何访问匿名接口o 3.4 接口数据如何适当的缓存o 3.5 如何避免rate limito 3.6 技术咨询和建议通过何种途径询问概述API平台应用日益丰富,为了让开发者更容易了解开发流程;为了规范API的接口,需要制定开发规范;为了对开发者进行一些深层次的指导,让开发者怎样来最优的访问API接口,特此制定开发流程技术规范与指南。
开发流程申请APPKEY1. 进入2. 如果您有新浪微博账户,可以直接登录,没有则注册一个微博账户后登录3. 登录后进入我的应用,创建一个应用4. 创建完成后会生成对应的appkey,app_secret,记住:您的app_key别对外泄露。
应用创建及发布流程应用的创建及发布包括下面的流程,开发者可以根据应用当前的状态进行相应的操作开发指南SDK简介及作用SDK是特定语言实现的一个可以通用的API使用的工具,SDK实现了新浪开放平台的全部或大部分接口,以便开发者不用关心API接口细节,认证实现等,可以直接调用接口完成特定的功能。
支持新浪微博开放平台接口的SDK语言包括Adobe air,c++,c#,java,php,python,ios等,具体请参考SDK列表页面如何通过授权访问数据微博开放平台对外支持两种用户认证方式,Basic auth以及OAUTH认证微博开放平台对外支持两种用户认证方式,Basic auth以及OAUTH认证OAUTH认证OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准。
关于OAUTH协议可以参考使用OAUTH认证来获取微博数据介绍详细见:OAuth如何访问匿名接口为了方便一些应用在没有用户认证情况下需要获取一些数据,微博开放平台提供了一些匿名访问接口。
腾讯微博开放API文档
腾讯微博开放API 协议格式时间:2010-12-28Starjiang 注意:文档中所有参数请在使用时小写Oauth 授权Oauth授权简介,请先熟悉OAUTH协议,这个去GOOGLE一下吧,你会找到很多1.request_token https:///cgi-bin/request_tokenURLhttps:///cgi-bin/request_token格式xml,jsonHTTPS请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数oauth_callback:回调URLoauth_consumer_key:你申请的appkeyoauth_nonce:随机串(32个字符长度)oauth_signature:oauth请求签名oauth_signature_method:签名方法(HMAC-SHA1)oauth_timestamp:时间戳oauth_version:oauth版本号填(1.0)使用说明https:///cgi-bin/request_token?oauth_callback=http%3A%2F%%2 Foauthapi%2Fcallback.php&oauth_consumer_key=0aae7ba5c10d4b939694b0b3b9ffe8ac&oauth _nonce=b788149731e0ed75daa03a6e1e30427c&oauth_signature=zO5%2FgT%2FP6tbhBBZVuo yfjPwjdxY%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1288932298&oaut h_version=1.0返回串:oauth_token=a63f4a0e1242462fb8c11e53159ba294&oauth_token_secret=40ece707e064128e4fec 692e3c09c692&oauth_callback_confirmed=trueOauth_token: 返回的request_tokenoauth_token_secret: 返回的request_secretoauth_callback_confirmed: 回调确认2.用户授权request_token https:///cgi-bin/authorize https:///cgi-bin/authorize?oauth_token=80484decceb142dfaf5791c9cb9cd256授权后,回调URL/oauthapi/callback.php?oauth_token=80484decceb142dfaf5791c9cb9cd256 &oauth_verifier=3355663.交换access_token https:///cgi-bin/access_tokenURLhttps:///cgi-bin/access_token格式xml,jsonHTTPS请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数oauth_callback:回调URLoauth_consumer_key:你申请的appkeyoauth_nonce:随机串(32个字符长度)oauth_signature:oauth请求签名oauth_signature_method:签名方法(HMAC-SHA1)oauth_timestamp:时间戳Oauth_token: request_tokenoauth_version:oauth版本号填(1.0)oauth_verifier:验证码使用说明https:///cgi-bin/access_token?oauth_consumer_key=0aae7ba5c10d4b939694b0b3b9 ffe8ac&oauth_nonce=35885b07fe7dc53942d405e552d086fe&oauth_signature=TXBihj%2FH4av LJaWmjYARDVVCu8M%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1288 933101&oauth_token=66ae88faecd14a1f8e826d35d5e857a7&oauth_verifier=335566&oauth_ver sion=1.0返回:oauth_token=ffc37464473e48a2b22226350dc98210&oauth_token_secret=3fe92ec42e936672ceca 549d432c237d&name=starjiangoauth_token: access_tokenoauth_token_secret: access_secretName: 微博帐户名API请求示例说明注:所有API调用带上oauth的标准参数,及附加参数,oauth标准参数作认证鉴权用,附加参数:即api请求参数(不同API有不同的附加参数),例:/api/statuses/home_timeline?oauth_consumer_key=27d1186 230a443d1ac7f514a96376ada&oauth_nonce=5d24c2ae0124a80f9c7b64e43e0ff31e &oauth_signature=n%2BmyL1FVXTSzNjgxCLoQoND1hNk%3D&oauth_signa ture_method=HMAC-SHA1&oauth_timestamp=1290668241&oauth_token=adf bbe3c7f1043d2932878e95350eecb&oauth_version=1.0&format=json&pageflag=0 &reqnum=20&pagetime=0oauth标准参数说明oauth_consumer_key:你申请的appkeyoauth_nonce:随机串(32个字符长度)oauth_signature:oauth请求签名oauth_signature_method:签名方法(HMAC-SHA1)oauth_timestamp:时间戳Oauth_token: access_tokenoauth_version:oauth版本号填(1.0)符加参数Formatpageflagreqnumpagetime时间线1.Statuses/home_timeline 主页时间线URL/api/statuses/home_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pageflag 分页标识(0:第一页,1:向下翻页,2向上翻页)PageTime: 本页起始时间(第一页时填0,继续翻页:填上一次请求返回的最后一条记录时间,)Reqnum: 每次请求记录的条数(1-20条)使用说明/api/statuses/home_timeline?format=json&pageflag=0&reqnum=20&pagetim e=0返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,//此字段为服务器当前时间,不能用于翻页hasNext:0,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0,Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳".Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳,不能用于翻页hasNext:0 表示还有微博可拉取1 已拉取完毕Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Country_code:国家码(其他时间线一样)Province_code:省份码(其他时间线一样)City_code:城市码(其他时间线一样)Isvip:是否微博认证用户Geo:发表者地理信息Status:微博状态0-正常,1-系统删除2-审核中3-用户删除4-根删除Source:当Type=2 时,source 即为源TWEETUser:Name:nick 当页数据涉及到的用户的帐号与昵称映射2.Statuses/public_timeline 广播大厅时间线URL/api/statuses/public_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pos: 记录的起始位置(第一次请求是填0,继续请求进填上次返回的Pos)Reqnum: 每次请求记录的条数(1-20条)使用说明/api/statuses/public_timeline?format=json&pos=0&reqnum=20 返回结果{ret:0,Msg:"ok",Data:{Pos:20,Timestamp:128679200,hasNext:0,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0,Geo:null,Status:0,},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0,Geo:null,}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息User:Name:nick 当页数据涉及到的用户的帐号与昵称映射3.Statuses/user_timeline 其他用户发表时间线URL/api/statuses/user_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pageflag 分页标识(0:第一页,1:向下翻页,2向上翻页)PageTime: 本页起始时间(第第一页时填0,继续翻页:填上一次请求返回的最后一条记录时间,Reqnum: 每次请求记录的条数(1-20条)Lastid: 第一页时填0,继续向下翻页,填上一次请求返回的最后一条记录ID,翻页用Name : 你需要读取该用户的用户名使用说明/api/statuses/user_timeline?format=json&pageflag=0&reqnum=20&pagetime =0返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,totalNum:100,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳"isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳"isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick', ............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Totalnum:所有记录的总数Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息Source:当Type=2 时,source 即为源TWEETUser:Name:nick 当页数据涉及到的用户的帐号与昵称映射4.Statuses/mentions_timeline 用户提及时间线URL/api/statuses/mentions_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pageflag 分页标识(0:第一页,1:向下翻页,2向上翻页)PageTime: 本页起始时间(第一页时填0,继续向下翻页:填上一次请求返回的最后一条记录时间)Reqnum: 每次请求记录的条数(1-20条)Lastid: 第一页时填0,继续向下翻页,填上一次请求返回的最后一条记录ID,翻页用使用说明/api/statuses/mentions_timeline?format=json&pageflag=0&reqnum=20&page time=0返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,totalNum:100,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳"isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Totalnum:记录总数Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息Source:当Type=2 时,source 即为源TWEETUser:Name:nick 当页数据涉及到的用户的帐号与昵称映射5.Statuses/ht_timeline 话题时间线URL/api/statuses/ht_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Httext: 话题名字Pageflag 分页标识(PageFlag = 1表示向后(下一页)查找;PageFlag = 2表示向前(上一页)查找;PageFlag = 4表示跳到最前一页)pageinfo: 分页标识(第一页填空,继续翻页:填上上次返回的pageinfo)Reqnum: 每次请求记录的条数(1-20条)使用说明/api/statuses/ht_timeline?format=json&pageflag=1&reqnum=20&pageinfo= 返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,Pageinfo:"adcdef452bde",Totalnum:1000,Id:123456,Isfav:1Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳"isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳Pageinfo: 翻页标识hasNext:2表示不能往上翻1 表示不能往下翻,0表示两边都可以翻Totalnum:话题下微博总数Isfav: 是否收藏1是0 否Id:话题IDInfo:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息Source:当Type=2 时,source 即为源微博User:Name:nick 当页数据涉及到的用户的帐号与昵称映射6.Statuses/broadcast_timeline 我发表时间线URL/api/statuses/broadcast_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pageflag 分页标识(0:第一页,1:向下翻页,2向上翻页)PageTime: 本页起始时间(第一页时填0,继续向下翻页:填上一次请求返回的最后一条记录时间)Reqnum: 每次请求记录的条数(1-20条)Lastid: 第一页时填0,继续向下翻页,填上一次请求返回的最后一条记录ID,翻页用使用说明/api/statuses/broadcast_timeline?format=json&pageflag=0&reqnum=20&page time=0返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,totalNum:100,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息Source:当Type=2 时,source 即为源TWEETUser:Name:nick 当页数据涉及到的用户的帐号与昵称映射7.Statuses/special_timeline 特别收听的人发表时间线URL/api/statuses/special_timeline格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Pageflag 分页标识(0:第一页,1:向下翻页,2向上翻页)PageTime: 本页起始时间(第一页时填0,继续向下翻页:填上一次请求返回的最后一条记录时间)Reqnum: 每次请求记录的条数(1-20条)使用说明/api/statuses/special_timeline?format=json&pageflag=0&reqnum=20&pageti me=0返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,totalNum:100,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Source:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null,Status:0}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息Source:当Type=2 时,source 即为源TWEET User:Name:nick 当页数据涉及到的用户的帐号与昵称映射微博相关1.t/show 获取一条微博数据URL/api/t/show格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)id: 微博ID使用说明/api/t/show?format=json&id=222423553 返回结果{ret:0,Msg:"ok",Data:{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Source:{text:"",Origtext:"",Count:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Self:0Timestamp:1285813236,Type:1,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null},Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null}}2.t/add 发表一条微博URL/api/t/add格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)content: 微博内容Clientip: 用户IP(以分析用户所在地)Jing: 经度(可以填空)Wei: 纬度(可以填空)使用说明/api/t/addPost包体格式:format=json&content=xxxx&clientip=127.0.0.1&jing=110.5&wei=23.4 返回结果{ret:0,Msg:"ok",Errcode:0,Data:{id:12345678,Timestamp:12863444444}}Errcode :发表失败错误码参看文档最后说明3.t/del 删除一条微博URL/api/t/del格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)Id: 微博ID使用说明/api/t/delPost包体格式:Format=json&id=xxxxx返回结果{ret:0,Msg:"ok",Data:{id:12345678,}}4.t/re_add 转播一条微博URL/api/t/re_add格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)content: 微博内容Clientip: 用户IP(以分析用户所在地)Jing: 经度(可以填空)Wei: 纬度(可以填空)Reid: 转播父结点微博ID使用说明/api/t/re_addPost包体格式:format=json&content=xxxx&clientip=127.0.0.1&jing=110.5&wei=23.4&reid=12315456 返回结果{ret:0,Msg:"ok",Errcode:1Data:{id:12345678,Timestamp:12863444444}}Errcode :发表失败错误码参看文档最后说明5.t/reply 回复一条微博URL/api/t/reply格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)content: 微博内容Clientip: 用户IP(以分析用户所在地)Jing: 经度(可以填空)Wei: 纬度(可以填空)Reid: 回复的父结点微博ID使用说明/api/t/replyPost包体格式:format=json&content=xxxx&clientip=127.0.0.1&jing=110.5&wei=23.4&reid=12315456 返回结果{ret:0,Msg:"ok",Errcode:13,Data:{id:12345678,Timestamp:12863444444}}6.t/add_pic 发表一条带图片的微博URL/api/t/add_pic格式xml,jsonHTTP请求方式POST提交数据采用enctype="multipart/form-data"是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明Format: 返回数据的格式是(json或xml)content: 微博内容Clientip: 用户IP(以分析用户所在地)Jing: 经度(可以填空)Wei: 纬度(可以填空)Pic:文件域表单名本字段不要签名的参数中,不然请求时会出现签名错误使用说明/api/t/add_picPost包体格式:返回结果{ret:0,Msg:"ok",Errcode:13,Data:{id:12345678,Timestamp:12863444444}}7.t/re_count 转播数URL/api/t/re_count格式xml,jsonHTTP请求方式get是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明Format: 返回数据的格式是(json或xml)Ids: 微博ID的列表Flag:0 获取转发计数,1点评计数2 两者都取使用说明/api/t/re_count?format=json&ids=253446341312,34243234242,64323443234, 34342344424334返回结果{ret:0,Msg:"ok",Data:{"253446341312":1,"34243234242":2,..........}}两者都取时返回数据格式{ret:0,Msg:"ok",Data:{"253446341312":{'count':10,'mcount',3},"34243234242":{'count':10,'mcount',3},..........}}返回说明:Data:"微博ID":转播数Count:转播数,mcount:点评数8.t/re_list 获取单条微博的转发或点评列表URL/api/t/re_list格式xml,jsonHTTP请求方式get是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 数据返回的格式(json或XML)Flag:标识0 转播列表,1点评列表2 点评与转播列表RootId:转发或者回复根结点ID(源微博ID);PageFlag:(根据dwTime),0:第一页,1:向下翻页,2向上翻页;PageTime: 本页起始时间(第一页时填0,继续向下翻页:填上一次请求返回的最后一条记录时间)Reqnum: 每次请求记录的条数(1-20条)TwitterId: 第一页时填0,继续向下翻页,填上一次请求返回的最后一条记录ID,翻页用使用说明/api/t/re_list?format=json&rootid=xxxx&&pageflag=0&pagetime=12345332 34&TwitterId=xxxxx&reqnum=20返回结果{ret:0,Msg:"ok",Data:{Timestamp:128679200,hasNext:0,Totalnum:300,Info:[{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:["",""],Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:2,//表示转播Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null},{text:"",Origtext:"",Count:2,Mcount:2,From:"来自网页",Id:7987543214334,Image:null,Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Self:0Timestamp:1285813236,Type:2,Head:"",Location:"广东深圳",Country_code:1,Province_code:44,City_code:3,isVip:0Geo:null}]},'User':{'name':'nick','name':'nick',............}}字段说明:Ret: 0 成功非0失败Msg 错误信息Data:Timestamp 服务器时间戳hasNext:0 表示还有微博可拉取1 已拉取完毕Info:Text:微博内容Origtext:原始内容Count:微博被转次数Mcount:点评次数From:来源Id:微博唯一IDImage:图片URL列表Name:发表人帐户名Nick:发表人昵称Self:是否自已发的的微博0:不是1 是Timestamp:发表时间Type:微博类型1-原创发表、2-转载、3-私信4-回复5-空回6-提及Head:发表者头像URLLocation:发表者所在地Isvip:是否微博认证用户Geo:发表者地理信息User:Name:nick 当页数据涉及到的用户的帐号与昵称映射9.t/comment 点评一条微博URL/api/t/c omment格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数Format: 返回数据的格式是(json或xml)content: 微博内容Clientip: 用户IP(以分析用户所在地)Jing: 经度(可以填空)Wei: 纬度(可以填空)Reid: 转播根结点(非父结点)微博ID使用说明/api/t/c ommentPost包体格式:format=json&content=xxxx&clientip=127.0.0.1&jing=110.5&wei=23.4&reid=12315456 返回结果{ret:0,Msg:"ok",Errcode:1Data:{id:12345678,Timestamp:12863444444}}Errcode :发表失败错误码参看文档最后说明帐户相关er/info获取自己的详细资料URL/api/user/info格式xml,jsonHTTP请求方式GET是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)使用说明/api/user/info?format=json返回结果{ret:0,Msg:"ok",Data:{Name:"abc",Nick:"abcd",Uid:"xxxxxxxxx",Head:"",Location:"广东深圳",Country_code:"1",Province_code:"44",City_code:"3",isVip:0,Isent:0,Introduction:"",verifyInfo:"",Birth_year:"1984"Birth_month:"3"Birth_day:"28"Sex:1Fansnum:100,Idolnum:100,Tweetnum:100Tag:[{Id:1,name:""},{id:2,name:""},....]}}字段说明:Name: 用户帐户名Nick: 用户昵称Uid: 用户id(目前为空)Head: 头像URLLocation: 所在地Isvip: 是否认证用户Isent: 是否企业机构Introduction: 个人介绍Verifyinfo: 认证信息Birth_year: 出生年Birth_month:出生月Birth_day:出生天Country_code: 国家ID,Province_code: 地区ID,City_code: 城市ID,Sex:用户性别1男2 女0未知Fansnum:粉丝数Idolnum:偶像数Tweetnum:发表的微博数Tag:Id:个人标签IDName:标签名er/update 更新用户信息URL/api/user/update格式xml,jsonHTTP请求方式POST是否需要鉴权true请求数限制true关于请求数限制,参见接口访问权限说明请求参数:oauth标准参数,并带上以下参数Format: 返回数据的格式是(json或xml)nick: 昵称Sex: 性别0 ,1:男2:女Year:出生年1900-2010Month:出生月1-12Day:出生日1-31。
新浪微博API
thunder://QUFodHRwOi8vczg1LmZyZWUtZHZkOS5jb20vaGQtZHZkL2R2ZDktMjAwOTE xMjUwNC5yYXJaWg==API文档出自新浪微博API跳转到:导航, 搜索目录隐藏•1微博基础数据接口(Rest API)o 1.1获取下行数据集(timeline)接口o 1.2微博访问接口o 1.3用户接口o 1.4私信接口o 1.5关注接口o 1.6Social Graph接口o 1.7账号接口o 1.8收藏接口o 1.9表情接口o 1.10登录/OAuth接口•2微博搜索API (Search API)o 2.1用户搜索o 2.2微博搜索•3微博地理位置信息API (Location API)o 3.1地理信息搜索接口o 3.2坐标获取接口•4测试接口•5附录o 5.1Rest API字段说明o 5.2地理信息字段说明微博基础数据接口(Rest API)获取下行数据集(timeline)接口•statuses/public_timeline获取最新更新的公共微博消息•statuses/friends_timeline获取当前用户所关注用户的最新微博信息(别名: statuses/home_timeline)•statuses/user_timeline获取用户发布的微博信息列表•statuses/mentions获取@当前用户的微博列表•statuses/comments_timeline获取当前用户发送及收到的评论列表•statuses/comments_by_me获取当前用户发出的评论•statuses/comments获取指定微博的评论列表•statuses/counts批量获取一组微博的评论数及转发数•statuses/unread获取当前用户未读消息数微博访问接口•statuses/show根据ID获取单条微博信息内容•user/statuses/id根据微博ID和用户ID跳转到单条微博页面•statuses/update发布一条微博信息•statuses/upload上传图片并发布一条微博信息•statuses/destroy删除一条微博信息•statuses/repost转发一条微博信息(可加评论)•statuses/comment对一条微博信息进行评论•statuses/comment_destroy删除当前用户的微博评论信息•statuses/reply回复微博评论信息用户接口•users/show根据用户ID获取用户资料(授权用户)•statuses/friends获取当前用户关注对象列表及最新一条微博信息•statuses/followers获取当前用户粉丝列表及最新一条微博信息私信接口•direct_messages获取当前用户最新私信列表•direct_messages/sent获取当前用户发送的最新私信列表•direct_messages/new发送一条私信•direct_messages/destroy删除一条私信关注接口•friendships/create关注某用户•friendships/destroy取消关注•friendships/exists是否关注某用户(推荐使用friendships/show)•friendships/show获取两个用户关系的详细情况Social Graph接口•friends/ids 获取用户关注对象uid列表•followers/ids 获取用户粉丝对象uid列表账号接口•account/verify_credentials验证当前用户身份是否合法•account/rate_limit_status获取当前用户API访问频率限制•account/end_session当前用户退出登录•account/update_profile_image更改头像•account/update_profile更改资料•account/register注册新浪微博帐号•Account/activate二次注册微博的接口收藏接口•favorites获取当前用户的收藏列表•favorites/create添加收藏•favorites/destroy删除当前用户收藏的微博信息表情接口•emotions表情接口,获取表情列表登录/OAuth接口•oauth OAuth授权方式介绍•oauth/request_token获取未授权的Request Token•oauth/authorize请求用户授权Token•oauth/access_token获取授权过的Access Token微博搜索API (Search API)Search API仅对新浪合作开发者开放,申请请联系@微博开放平台用户搜索•users/search搜索微博用户(仅对新浪合作开发者开放)微博搜索•search搜索微博文章(仅对新浪合作开发者开放)•statuses/search搜索微博(多条件组合) (仅对合作开发者开放) 微博地理位置信息API (Location API)Map API仅对新浪合作开发者开放,有任何问题,请联系@地理信息开放平台地理信息搜索接口•Location/route驾车路线搜索接口•Location/bus公交换乘路线搜索接口坐标获取接口•Location/ip2xy获取ip对应坐标的接口•Location/addr2xy获取地址对应坐标的接口•Location/get_addr获取坐标的地址信息的接口测试接口•Help/test测试接口附录Rest API字段说明•status微博信息内容•user用户资料信息•comment评论信息描述•direct_message私信信息•省份城市编码表地理信息字段说明•Location/citycode城市代码对应表•Location/citycode_bus公交城市代码表•Location/category分类代码对应表取自"/wiki/index.php/API%E6%96%87%E6%A1%A3" 搜索平台介绍•文档首页•平台概述•应用开发者协议•开发指南•应用审核规范•成功案例开发文档•API文档•授权机制说明•接口访问权限说明•连接微博•微博组件资源下载•SDK•微博标识下载常见问题•开发过程常见问题•名词解释•常见错误代码及释义工具箱•链入页面•链出更改•特殊页面•可打印版•永久链接关于微博开放平台|联系我们|@微博开放平台|微博挂件|服务条款|新浪微博Copyright © 1996-2010 SINA Corporation, All Rights Reserved。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
微博API使用说明书
·关键词
·摘要
1. 概述
1.1 背景
应包含以下三个方面的内容:
A. 待开发软件系统名称。
B. 该系统基本概念, 如该系统的类型、从属地位等。
C. 开发项目组名称。
D. 项目代号。
1.2 参考资料
列出本文档引用的参考资料, 包括作者、标题、出版日期及密级。
1.3 术语和缩写词
网站接入、创建应用、API、
2. 总体设计
2.1 系统描述
2.1.1 需求规定
对所开发软件的概要描述, 包括主要的输入/输出、主要功能、性能等。
2.1.2 运行环境规定
对本系统所赖于运行的硬件、软件环境的描述
2.2 总体设计说明
2.2.1 基本设计概述
列出在描述、说明总体设计时要用到的一些基本概念,给出其解释说明。
2.2.2 设计思想
说明在进行总体设计时的基本考虑。
结合设计限制,说明如何根据这些设计限制综合考虑,而建立起目标系统的总体结构并进行功能划分,如有必要,可将所考虑过的多个总体设计作对比分析, 说明选择当前总体结构的原因。
2.3 系统结构和处理流程
本章节内容可以直接援引更详细的文档(如完备的详细系统逻辑模型)。
2.3.1 系统结构
用框图形式说明目标系统的模块划分, 扼要说明每个模块的标识符和功能, 分层次地给出各元素之间的控制与被控制关系。
2.3.2 处理流程
用数据流图的形式描述系统的处理流程,即输入是如何变成输出的。
2.4 功能分配
用二维矩阵图表的形式说明系统的各功能需求的实现同各模块的分配覆盖关系。
用于内部支撑的功能模块不必列入。
3. 具体实施。