v3/spread/del_appassist_msg

目录

1 功能说明

用户好友给用户发送请求或赠送免费礼物后,用户会在平台的应用消息中心中会收到相关信息。
目前应用消息中心不会对用户已经点击过的应用消息进行清理,会导致用户产生困惑。例如用户已经接受了好友送给他的礼物,但是在平台消息中心,赠送礼物的消息仍然存在。

为解决以上问题,应用需要主动调用本接口,当用户通过平台的应用消息中心点击其中一条信息进入应用后,或用户通过应用内部的信息中心对该信息进行处理后,调用本接口即可删除该条信息,无需用户再去平台的应用消息中心里删除,从而提升用户体验。

:本接口仅支持空间和朋友平台。

效果展示
QQ空间应用调用本接口效果展示如下:
在应用消息中心,会收到好友请求等消息,如下图所示。
del_appassist_msg_1.png
用户点击一条消息进入应用后,应用调用本接口自动删除消息中心关于本应用的消息,如下图所示。
del_appassist_msg_2.png

腾讯朋友应用调用本接口效果展示如下:
在应用消息中心,会收到好友请求等消息,如下图所示。
del_appassist_msg_3.png
用户点击一条消息进入应用后,应用调用本接口自动删除消息中心关于本应用的消息,如下图所示。
del_appassist_msg_4.png


2 接口调用说明

2.1 URL

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

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

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数
无。

2.6 请求示例

http://113.108.20.23/v3/spread/del_appassist_msg?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=qzone&
format=json&
userip=112.90.139.30

2.7 返回参数说明

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

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

2.8 正确返回示例

JSON示例:

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

2.9 错误返回示例

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

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部