分享到 :

OpenApi接口调用说明_Android_SDK

1. 接口说明

在SDK中,还有一些功能不需要SDK提供UI交互的OpenApi接口,如获取用户信息、获取用户相册列表、发送分享(addshare)、发表说说、上传图片、创建相册等,更多功能接口请查看《API列表》。

这些功能统一通过调用Tencent类的request或requestAsync方法来实现。request和requestAsync这两个接口的功能相同,区别是一个是同步调用,一个是异步调用。

2. 使用场景

此接口主要用调用没有被SDK分装成单独接口的OpenApi。

3. 接口调用说明

3.1 接口方法

同步调用:JSONObject com.tencent.tauth.Tencent.request(String graphPath, Bundle params, String httpMethod)

异步调用:void com.tencent.tauth.Tencent.requestAsync(String graphPath, Bundle params, String httpMethod, IRequestListener listener, Object state)

3.2 参数说明

参数 参数说明
graphPath 要调用的接口名称,通过SDK中的Constant类获取宏定义。
params 以K-V组合的字符串参数。Params是一个Bundle类型的参数,里面以键值对(Key-value)的形式存储数据,应用传入的邀请分享等参数就是通过这种方式传递给SDK,然后由SDK发送到后台。
httpMethod 使用的http方式,如Constants.HTTP_GET,Constants.HTTP_POST。
listener 回调接口,IUiListener实例。
state 状态对象,将在回调时原样传回给 listener,供应用识别异步调用。SDK内部不访问该对象。

其中的graphPath参数用于区别不同的功能接口。

详细的参数值与功能接口的对应,请参照下面的表格:

参数值 接口说明
Constants.GRAPH_SIMPLE_USER_INFO 获取用户信息,返回用户昵称、头像URL、是否黄钻用户、黄钻等级等。
Constants.GRAPH_ADD_ALBUM 创建一个QQ空间相册。
Constants.GRAPH_LIST_ALBUM 获取用户QQ空间相册列表,返回用户相册列表以及每个相册的详细信息。
Constants.GRAPH_ADD_SHARE 发送分享,不支持@好友功能。
Constants.GRAPH_ADD_TOPIC 发表一条说说到QQ空间。
Constants.GRAPH_UPLOAD_PIC 上传一张照片到QQ空间相册。

3.3 示例代码

同时,您也可以查看Android开发指南中《获取用户信息》来熟悉该接口的调用。

3.4 返回码说明

0: 正确
其它: 失败
OpenAPI公共错误码说明详见:Android常见问题公共返回码说明

返回顶部