v3/user/check_crosstask_status

目录

1 功能说明

自定义任务查询接口,用于判断用户在流量导入应用内的具体行为是否完成,如等级、通过指定关卡等,常用于深度合作应用间导量,可明显提高用

户对应用认知。
上线前,需将以下信息发送邮件至kenqczhang@tencent.com申请,获得taskid后方可实现功能。

需提供 举例
流量导出方appid 12345678
流量导入方appid 87654321
任务步骤描述 在目标应用中达到5级
host appact.qzone.qq.com
ip 1.1.1.1
port 80
url /cgi-bin/comm/asdfsdf

如果ip和端口不填,则默认使用host的方式查询。
注:
平台判断查询权限之后,会调用流量导入方的api,调用的格式为:

host/url?taskid=1&openid=84BD103D20F85E25BA6DBA5436F72999&appid_buyer=1101081166&appid_seller=1111

其中,openid为导入方的openid,该api的返回格式为json,格式必须包含:result和msg

{"result":1001,"msg":"params error"

2 接口调用说明

2.1 格式

json

2.2 HTTP请求方式

GET

2.3 IP限制

TRUE

2.4 输入参数说明

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

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

(2)私有参数

参数名称 是否必须 类型 描述
taskid 查询的任务
buyer_appid 查询的买家appid


2.5 请求示例

URL编码前的请求:

https://openapi.tencentyun.com/v3/user/check_crosstask_status?
appid=15499&
openid=00000000000000000000000014BDF6E4&
openkey=803C46E09AACA641351D7121C4746FC3&
pf=qzone&
format=json&
userip=112.90.139.30&
tasked=abc_sdf_cds&
buyer_appid=12332434
sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D

2.6 返回参数说明

参数名称 描述
ret 返回码。

私有返回码说明如下:
0:成功返回;
1: 参数错误;
2000:系统错误,数据读取失败;
2100:没有该任务;
2200:没有访问该任务的权限;
2300:访问该任务的买方查询接口失败;
公共返回码详见公共返回码说明#OpenAPI V3.0 返回码

message 错误信息。
time 接口返回时间。
finish 用户是否完成任务,只有ret=0才会显示此字段

2.7 正确返回示例

JSON示例:

{"finish":0,"message":"","msg":"fail","ret":0,"time":1392637406}
{"finish":1,"message":"","msg":"success","ret":0,"time":1392637406}

2.8 错误返回示例

{"message":"请求参数错误","ret":1,"time":1392636086}
{"message":"系统错误,数据读取失败","ret":2000,"time":1392636086}
{"message":"没有该任务","ret":2100,"time":1392636086}
{"message":"没有访问该任务的权限","ret":2200,"time":1392636086}
{"message":"访问该任务的买方查询接口失败!","ret":2300,"time":1392636086}

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部