v3/pay/appstore_activity

目录

1 功能说明


1.1 接口调用说明

所有接入腾讯开放平台的应用都必须接入本接口,用于拉取用户空间活动信息。
Step1:开发者需在用户进入应用时调用本接口,并按照接口返回值说明进行空间活动的展示控制。
Step2:当本接口返回码act_action字段值为Fusion时,需调用fusion2.dialog.showCouponActivity接口。

注意:请仔细查看返回码说明,并完成相关逻辑开发。

1.2 功能场景说明

开发者需在应用主界面显示“空间活动” icon,用户点击后按照本接口返回码要求,进行弹窗或跳转。
空间活动中心icon样式如下:

v3payappstore_activity-1.png
icon展示示例:

v3payappstore_activity-2.png

2 接口调用说明

2.1 URL

https://[域名]/v3/pay/appstore_activity

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

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 IP限制

TRUE

2.5 输入参数说明

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

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

(2)私有参数
无。

2.6 请求示例

本接口的签名生成较为复杂,许多应用在此出错,因此下面演示了sig签名的生成细节。开发者可以下面的示例来验证sig的计算方法,但不能直接复制。

method:GET
url_path:/v3/pay/appstore_activity
假设appkey为:56abfbcd12fe46f5ad85ad9f2faf36d7
请求参数包括:
appid: 15499
openid: 00000000000000000000000014BDF6E4
openkey:803C46E09AACA641351D7121C4746FC3
pf: qzone
sig: sig生成方法请参见:这里
URL编码前的请求: https://119.147.19.43/v3/pay/appstore_activityappid=15499&openid=00000000000000000000000014BDF6E4&
openkey=803C46E09AACA641351D7121C4746FC3&pf=qzone&sig=asdadadadadsad

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
icon_display 是否显示活动中心icon:

0:展示
1:不展示

icon_url_big 从该地址中下载活动中心icon图片。64*64尺寸,png格式。应用自行选择使用大尺寸icon 或者小尺寸icon。
icon_url_small 从该地址中下载 icon图片。52*52尺寸,png格式。应用自行选择使用大尺寸icon 或者 小尺寸icon
act_info 正在进行活动信息文本。应用可直接将信息展现到商城等区域,鼓励用户消费。当没有活动信息时,本字段为空
strong_push 判断何时触发 act_action动作。

false: 点击空间活动中心图标时触发
true: 用户进入游戏即强行触发

act_action 活动推广方式:

fusion: 调用fusion2.dialog.showCouponActivity
page: 在新页面打开网页。

link_url 当act_action为page时,返回页面的跳转链接;

当act_action值为Fusion时不返回本字段

code 错误码,同ret;
subcode 错误码,同ret;
time 返回时间;


2.8 正确返回示例

JSON示例:

{
"act_action":"page",
"act_info":"11.11500万Q点免费领取",
"code":0,
"subcode":0,
"icon_display":0,
"icon_url_big":"appstore_activity_icon_big_64x64_new.png",
"icon_url_small":"appstore_activity_icon_small_52x52_new.png",
"message":"",
"ret":0,
"strong_push":false,
"time":1384161878,
"link_url":www.qq.com,

}

2.9 错误返回示例

无。

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部