v3/spread/is_app_onpanel

目录

1 接口使用权限

开发者的星级为1星及以上,可申请本接口的使用权限。
调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

2 功能说明

调用接口fusion2.dialog.addClientPanel后,用户可以将应用的图标添加到QQ主面板。
调用本接口,可以查询到应用是否被添加到QQ主面板。

3 接口调用说明

3.1 URL

http://[域名]/v3/spread/is_app_onpanel

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

3.2 格式

json,xml

3.3 HTTP请求方式

GET, POST

3.4 IP限制

TRUE

3.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数
无。

3.6 请求示例

GET 请求包示例(这里仅为示例,不能直接拷贝,请根据应用的实际情况输入相应的参数值):

http://openapi.tencentyun.com/v3/spread/is_app_onpanel?
openid=0000000000000000000000002329FBEF&
openkey=4EC7BF056460699AA2CEAFEA3C5DDADC&
appid=100646885&
pf=qzone&
format=json&
userip=112.90.139.30&
sig=hJoM2%2F7C0jELOCVPrBwpbMBu54g%3D

3.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

in_applist 0:应用未被添加到QQ主面板。

1:应用存在于用户QQ主面板。

3.8 错误返回码说明

公共错误返回码:公共返回码说明#OpenAPI V3.0 返回码
本接口私有错误返回码:暂无。

3.9 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"is_lost":0,
"in_applist":1
}

3.10 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}

4 相关文档

fusion2.dialog.addClientPanel

以上信息是否解决您的问题?

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部