腾讯微博java(android) api

由于现在腾讯微博提供的java(android) sdk功能过弱，自己搞了个java sdk包，同样适用于android。包含腾讯微博目前提供的95%的api，几乎所有主要功能api，用法简单（微博、评论、转发、私信同一个实体类），方便扩展（可以根据自己需要修改源代码或是继承QqTSdkService类，当然为了后续依然能升级版本建议采用继承的方式）。

 

下面介绍源码地址和jar包地址，然后介绍api的具体使用

1、源码和jar包下载

QqTAndroidSdk-1.0.0.jar为sdk主代码，其中的QqTSdkServiceImpl包含了所有接口的实现，下面第二部分对此中接口进行介绍

jar包地址：QqTAndroidSdk-1.0.0.jar

google code源码地址：http://code.google.com/p/qq-t-java-sdk/source/browse/

github源码地址：https://github.com/Trinea/qq-t-java-sdk

 

JavaCommon-1.0.0.jar为QqTAndroidSdk依赖的公用处理包，包含字符串、list、数组、map、json工具类等等

jar包地址：已经包含在QqTAndroidSdk-1.0.0.jar中

google code源码地址：http://code.google.com/p/trinea-java-common/source/browse/

github源码地址：https://github.com/Trinea/JavaCommon

 

2、具体使用

参数同腾讯微博api http://wiki.open.t.qq.com/index.php/API%E6%96%87%E6%A1%A3

注意：以下所有的api示例代码都需要先新建QqTSdkService类对象并初始化，初始化如下

/**
 * 分别设置应用的key、secret(腾讯提供)。用户的accesstoken和tokenSecret(OAuth获取)
 * 请用自己的相应字符串替换，否则无法成功发送和获取数据
 **/
QqTAppAndToken qqTAppAndToken = new QqTAppAndToken();
qqTAppAndToken.setAppKey("***"); // ***用应用key替换
qqTAppAndToken.setAppSecret("***"); // ***用应用secret替换
qqTAppAndToken.setAccessToken("***"); // ***用用户accesstoken替换
qqTAppAndToken.setTokenSecret("***"); // ***用用户tokenSecret替换

/** 新建QqTSdkService对象，并设置应用信息和用户访问信息 **/
QqTSdkService qqTSdkService = new QqTSdkServiceImpl();
qqTSdkService.setQqTAppAndToken(qqTAppAndToken);

关于以上的accessToken及tokenSecret的获取请见OAuth认证介绍及腾讯微博OAuth认证示例

 

下面就对接口进行介绍，并举例如何使用QqTAndroidSdk-1.0.0.jar中的api，每个接口都有三种返回参数，可以满足不同需求，接口主要分成几大类：

2.1、时间线（微博列表）

这20个接口包含了腾讯微博四部分api

1.1、时间线中的除statuses/ht_timeline_ext(话题时间线)以外的15个api

1.2、私信相关中的收件箱、发件箱两个api

1.3、数据收藏中的收藏的微博列表和获取已订阅话题列表两个api

1.4、微博相关中的获取单条微博的转发或点评列表api

以获取首页信息为例，示例代码如下：

QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();
/** 设置分页标识 **/
qqTTimelinePara.setPageFlag(0);
/** 设置起始时间 **/
qqTTimelinePara.setPageTime(0);
/** 每次请求记录的条数 **/
qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
/** 可以设置拉取类型，可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/
qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);
/** 可以设置微博内容类型，可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/
qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);
List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);
assertTrue(qqTStatusList != null);

这样qqTStatusList就保存了首页的20条数据，可以自己设置不同的类型参数

更多时间线数据获取见：腾讯微博java(android)sdk时间线api详细介绍 

 

2.2、新增微博api

8个接口包含了

2.1、微博相关中的发表一条微博、转播一条微博、回复一条微博、发表一条带图片微博、点评一条微博、发表音乐微博、发表视频微博、发表心情帖子。在api中发表一条微博和发表一条带图片微博合二为一。

2.2、私信相关中的发私信api

以新增一条微博为例，示例代码如下

qqTSdkService.addStatus("第一条状态哦", null);

其找第一个参数为状态内容，第二个参数为图片地址，不传图片为空即可

或者复杂点的如下，status可以设置其他地理位置信息等

QqTStatusInfoPara status = new QqTStatusInfoPara();
status.setStatusContent("发表一条带图片微博啦");
/** 发表带图微博，设置图片路径 **/
status.setImageFilePath("/mnt/sdcard/DCIM/Camera/IMAG2150.jpg");
assertTrue(qqTSdkService.addStatus(status, qqTAppAndToken));

更多新增微博api介绍见：腾讯微博java(android)sdk新增微博api详细介绍 

 

2.3、操作一条微博

这6个接口包含了腾讯微博三部分api

1.1、微博相关中的删除一条微博api。

1.2、私信相关中的删除私信api

1.3、数据收藏中收藏微博、取消收藏微博、订阅话题、取消订阅话题4个api

以收藏一条微博为例，示例代码如下

qqTSdkService.collect(12121);

其中参数为微博id

更多操作微博相关api介绍见： 腾讯微博java(android)sdk操作(删除.收藏.订阅等)微博api详细介绍

 

2.4、关系链列表（用户列表）

这10个接口包含了腾讯微博关系链相关中的互听关系链列表(对某个用户而言，既是他的听众又被他收听)、其他帐号听众列表、其他帐号收听的人列表、其他帐户特别收听的人列表、黑名单列表、我的听众列表、我的听众列表（只包含名字）、我收听的人列表、我收听的人列表（只包含名字）、我的特别收听列表10个api

以获取自己的收听用户为例，示例代码如下

QqTUserRelationPara qqTUserRelationPara = new QqTUserRelationPara();
qqTUserRelationPara.setReqNumber(QqTConstant.VALUE_PAGE_REQ_NUM);
qqTUserRelationPara.setStartIndex(0);
List<QqTUser> qqTUserList = qqTSdkService.getSelfInterested(qqTUserRelationPara);

这样qqTUserList就保存了自己的20位收听的用户信息

更多关系链列表相关api介绍见： 腾讯微博java(android)sdk关系链列表api详细介绍

 

2.5、用户建立关系

这6个接口包含了腾讯微博关系链相关中的收听某个用户、取消收听某个用户、特别收听某个用户、取消特别收听某个用户、添加某个用户到黑名单、从黑名单中删除某个用户共6个api

以关注某些用户为例，示例代码如下：

qqTSdkService.interestedInOther("wenzhang,li_nian,mayili007", null)

 更多用户建立关系相关api介绍见： 腾讯微博java(android)sdk用户建立关系api详细介绍

 

 

2.6、帐户相关

这7个接口包含了腾讯微博帐户相关中的获取自己的详细资料、更新用户信息、更新用户头像信息、更新用户教育信息、获取其他人资料、获取一批人的简单资料、验证账户是否合法（是否注册微博）共7个api。除获取心情微博api外

以获取自己的资料为例，示例代码如下：

QqTUser qqTUser = qqTSdkService.getSelfInfo();

 更多帐户相关api介绍见：腾讯微博java(android) sdk 帐户相关api详细介绍

 

2.7 搜索相关

这3个接口包含了腾讯微博搜索相关中的搜索用户、搜索微博、通过标签搜索用户共3个api。

以搜索微博为例，示例代码如下：

    public void testSearchStatus() {
        QqTSearchPara qqTSearchPara = new QqTSearchPara();
        qqTSearchPara.setKeyword("iphone");
        qqTSearchPara.setPage(1);
        qqTSearchPara.setPageSize(QqTConstant.VALUE_PAGE_REQ_NUM);
        List<QqTStatus> qqTStatusList = qqTSdkService.searchStatus(qqTSearchPara);
        assertTrue(qqTStatusList != null);
    }
 

 更多搜索相关api介绍见：腾讯微博java(android) sdk 搜索相关api详细介绍

 

2.8 热度趋势相关

这2个接口包含了腾讯微博热度趋势中的话题热榜、转播热榜用户共2个api。

以话题热榜为例，示例代码如下：

    public void testGetHotTopics() {
        QqTHotStatusPara qqTHotStatusPara = new QqTHotStatusPara();
        qqTHotStatusPara.setReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);
        qqTHotStatusPara.setLastPosition(0);
        /**
         * 1 话题名，2 搜索关键字 3 两种类型都有
         **/
        qqTHotStatusPara.setType(Integer.toString(1));
        List<QqTTopicSimple> hotTopicsList = qqTSdkService.getHotTopics(qqTHotStatusPara);
        assertTrue(hotTopicsList != null);
    }
 

 更多热度趋势相关api介绍见：腾讯微博java(android) sdk 热度趋势相关api详细介绍

 

2.9 数据更新相关

这1个接口为腾讯微博数据更新相关中的查看数据更新条数api。

示例代码如下：

    public void testGetUpdateInfoNum() {
        /** 设置clearType，对应QqTConstant.VALUE_CLEAR_TYPE_… **/
        QqTUpdateNumInfo qqTUpdateNumInfo = qqTSdkService.getUpdateInfoNum(true, QqTConstant.VALUE_CLEAR_TYPE_HOME_PAGE);
        assertTrue(qqTUpdateNumInfo != null);
    }

 更多数据更新相关api介绍见：腾讯微博java(android) sdk 数据更新相关api详细介绍

 

2.10  话题相关

这2个接口为腾讯微博话题相关中的根据话题名称查询话题id和根据话题id获取话题相关信息api。

示例代码如下：

    public void testGetTopicInfoByIds() {
        /** 先得到话题id **/
        Map<String, String> topicIdAndName = qqTSdkService.getTopicIdByNames("袁莉闪婚,美汁源下架,iphone");

        if (topicIdAndName != null) {
            /** 话题id列表，以逗号分隔 **/
            List<QqTStatus> qqtStatusList = qqTSdkService.getTopicInfoByIds(ListUtils.join(new ArrayList<String>(topicIdAndName.keySet())));
            assertTrue(qqtStatusList != null);
        } else {
            assertTrue(false);
        }
    }

 以上代码为先根据话题名得到话题id列表，然后为根据话题id获取话题相关信息接口，参数为话题id列表，以逗号分隔

 更多话题相关api介绍见：腾讯微博java(android) sdk 话题相关api详细介绍

 

2.11 标签相关

这2个接口为腾讯微博标签相关中的添加标签和删除标签api。

    public void testDeleteTag() {
        /** 删除自己的tag，先获取自己的资料，从中取中tag id **/
        QqTUser qqTUser = qqTSdkService.getSelfInfo();
        if (qqTUser != null && qqTUser.getTagMap() != null && qqTUser.getTagMap().size() > 0) {
            /** 删除tag **/
            for (Map.Entry<String, String> tag : qqTUser.getTagMap().entrySet()) {
                qqTSdkService.deleteTag(tag.getKey());
            }
        } else {
            assertTrue(false);
        }
    }

更多标签相关api介绍见：腾讯微博java(android) sdk 标签相关api详细介绍

 

你可能还感兴趣：

Android公共库(缓存 下拉ListView 下载管理Pro 静默安装 root运行 Java公共类)

Android ImageCache图片缓存

Android系统下载管理DownloadManager功能介绍及使用示例

下拉刷新及滚动到底部加载更多的Listview使用

viewpager实现画廊(一屏多个Fragment)效果

Android APK root权限静默安装

写在前面, 自己搭博客why and target

  

评论

17 楼 Trinea 2012-12-18  

黑色搁浅落寞 写道

你好！ 我是一个java小菜鸟   最近正负责公司游戏对腾讯微博的接口   能不能写个好友邀请和应用分享的代码   PS： 就是游戏中有好友列表 能邀请对方加入 ； 第二个是分享游戏链接

十分着急   帮帮我吧

自己看看腾讯的sdk包吧，最近也很忙，不弄这个了

16 楼 黑色搁浅落寞 2012-12-17  

你好！ 我是一个java小菜鸟   最近正负责公司游戏对腾讯微博的接口   能不能写个好友邀请和应用分享的代码   PS： 就是游戏中有好友列表 能邀请对方加入 ； 第二个是分享游戏链接

十分着急   帮帮我吧

15 楼 Trinea 2012-08-24  

cheqinzho 写道

你好，我获取了AccessToken 但没有TokenSecret 因为用的是Oau2.0 但发不了微博，这个有影响吗

因为腾讯的开放api oauth认证改用了2.0的方式，现在这种方法获取到了也发布不了微博，没时间看，抱歉

14 楼 cheqinzho 2012-08-23  

你好，我获取了AccessToken 但没有TokenSecret 因为用的是Oau2.0 但发不了微博，这个有影响吗

13 楼 Trinea 2012-03-20  

关于以上的accessToken及tokenSecret的获取请参见http://trinea.iteye.com/blog/1290627

12 楼 Trinea 2012-03-19  

dynafly 写道

您好，楼主，非常感谢楼主无私的例子，我有个问题想请教一下，我用您的包发送纯文字，视频都没问题，但是发送图片会报错 java.lang.IllegalArgumentException: Invalid uri，请楼主赐教，谢谢！

我刚看了下源码里的图片地址没问题，你可以看下图片路径是否正确。如果不行的话可以到
http://code.google.com/p/qq-t-java-sdk/source/checkout
下载源码调试看看

11 楼 Trinea 2012-03-19  

zbf_25 写道

楼主，我用的api，发送不了信息，就是基本的分享信息。能写个demo出来吗？
我是这样写的，麻烦你帮我看一下。
        QqTAppAndToken qqTAppAndToken = new QqTAppAndToken(); 
    qqTAppAndToken.setAppKey(APP_KEY); // ***用应用key替换 
    qqTAppAndToken.setAppSecret(APP_SECRET); // ***用应用secret替换
    qqTAppAndToken.setAccessToken(OAUTH_TOKEN);
    qqTAppAndToken.setTokenSecret(OAUTH_TOKEN_SECRET);
   
    /** 新建QqTSdkService对象，并设置应用信息和用户访问信息 **/ 
    qqTSdkService = new QqTSdkServiceImpl(); 
    qqTSdkService.setQqTAppAndToken(qqTAppAndToken); 

        QqTStatusInfoPara status = new QqTStatusInfoPara(); 
status.setStatusContent("分享一条微博啦"); 
boolean success = qqTSdkService.addStatus(status);
        if(success){
     Toast.makeText(context, "发布成功！", 3000).show();
}else{
     Toast.makeText(context, "发布失败！", 3000).show();
}

老是分享失败，怎么回事？你可以写个demo出来吗？谢谢！

抱歉，一直没时间抽出oauth认证的demo
        QqTAppAndToken qqTAppAndToken = new QqTAppAndToken(); 
    qqTAppAndToken.setAppKey(APP_KEY); // ***用应用key替换 
    qqTAppAndToken.setAppSecret(APP_SECRET); // ***用应用secret替换
    qqTAppAndToken.setAccessToken(OAUTH_TOKEN);
    qqTAppAndToken.setTokenSecret(OAUTH_TOKEN_SECRET);
这里面的APP_KEY、APP_SECRET、OAUTH_TOKEN、OAUTH_TOKEN_SECRET都是需要用你自己那边获取到的值替换的

10 楼 dynafly 2012-03-17  

您好，楼主，非常感谢楼主无私的例子，我有个问题想请教一下，我用您的包发送纯文字，视频都没问题，但是发送图片会报错 java.lang.IllegalArgumentException: Invalid uri，请楼主赐教，谢谢！

9 楼 zbf_25 2012-03-16  

楼主，我用的api，发送不了信息，就是基本的分享信息。能写个demo出来吗？
我是这样写的，麻烦你帮我看一下。
        QqTAppAndToken qqTAppAndToken = new QqTAppAndToken(); 
    qqTAppAndToken.setAppKey(APP_KEY); // ***用应用key替换 
    qqTAppAndToken.setAppSecret(APP_SECRET); // ***用应用secret替换
    qqTAppAndToken.setAccessToken(OAUTH_TOKEN);
    qqTAppAndToken.setTokenSecret(OAUTH_TOKEN_SECRET);
   
    /** 新建QqTSdkService对象，并设置应用信息和用户访问信息 **/ 
    qqTSdkService = new QqTSdkServiceImpl(); 
    qqTSdkService.setQqTAppAndToken(qqTAppAndToken); 

        QqTStatusInfoPara status = new QqTStatusInfoPara(); 
status.setStatusContent("分享一条微博啦"); 
boolean success = qqTSdkService.addStatus(status);
        if(success){
     Toast.makeText(context, "发布成功！", 3000).show();
}else{
     Toast.makeText(context, "发布失败！", 3000).show();
}

老是分享失败，怎么回事？你可以写个demo出来吗？谢谢！

8 楼 Trinea 2012-03-08  

xuan_handsome 写道

我想要个demo，楼主能给下吗？登录，分享(图片和文本)就可以了。[e-mail]谢谢

WebViewActivity是自己写的activity，很简单，即一个webview

7 楼 Trinea 2012-03-08  

xuan_handsome 写道

我想要个demo，楼主能给下吗？登录，分享(图片和文本)就可以了。[e-mail]谢谢

    private static QqTSdkService qqTSdkService = new QqTSdkServiceImpl();

    @Override
    public Intent auth(Context context, String callBackUrl) {
        Intent intent = new Intent();
        Bundle bundle = new Bundle();
        qqTSdkService.setQqTAppAndToken(getQqTAppAndToken());
        Map<String, String> requestTokenMap = qqTSdkService.getUnAuthorizedRequestToken(callBackUrl);
        if (!MapUtils.isEmpty(requestTokenMap) && requestTokenMap.containsKey(QqTConstant.PARA_OAUTH_TOKEN)) {
            Map<String, String> parasMap = new HashMap<String, String>();
            parasMap.put(QqTConstant.PARA_OAUTH_TOKEN, requestTokenMap.get(QqTConstant.PARA_OAUTH_TOKEN));
            bundle.putString(SnsConstant.OAUTH_URL,
                             HttpUtils.getUrlWithParas(QqTConstant.GET_AUTHORIZATION_URL, parasMap));
            bundle.putString(SnsConstant.CALL_BACK_URL, callBackUrl);
            bundle.putString(SnsConstant.REQUEST_TOKEN_SECRET, requestTokenMap.get(SnsConstant.REQUEST_TOKEN_SECRET));
            intent.putExtras(bundle);
            intent.setClass(context, WebViewActivity.class);
        }
        return intent;
    }

基本登录就是上面一段代码

其中 Map<String, String> requestTokenMap = qqTSdkService.getUnAuthorizedRequestToken(callBackUrl);
是我api中提供的接口，你可以自己看，返回的是一个map
OAUTH_URL表示认证的url http://open.t.qq.com/cgi-bin/authorize?oauth_token=自己的token
CALL_BACK_URL表示成功后跳转的地址

6 楼 xuan_handsome 2012-03-08  

我想要个demo，楼主能给下吗？登录，分享(图片和文本)就可以了。[e-mail]谢谢

5 楼 Trinea 2012-02-23  

lx82319214 写道

你好！能请教你个问题吗？我329716228.我隐身的！

很少上q
啥问题

4 楼 lx82319214 2012-02-22  

你好！能请教你个问题吗？我329716228.我隐身的！

3 楼 Trinea 2012-02-21  

ramesyang 写道

我想要个demo，楼主能给下吗？登录，分享(图片和文本)就可以了。[e-mail]谢谢

登录按照OAuth的几个步骤就可以了，得到了accessToken和tokenSecret后就可以使用这个依赖包了

2 楼 ramesyang 2012-02-21  

我想要个demo，楼主能给下吗？登录，分享(图片和文本)就可以了。[e-mail]谢谢

1 楼 zhou405680603 2011-12-19