任务同步接口

优质

小牛编辑

130浏览

2023-12-01

1.需求背景

在积分商城，或者签到页面中，开发者涉及到做任务领取奖励的情况，比如听歌，看书，开通会员等页面操作任务之后，在签到页面可以领取积分奖品等特殊奖品。因此需要涉及到签到任务同步接口。

接口有开发者提供，由兑吧触发请求。

2.接口请求说明（Get请求）

请求参数

字段名	字段类型	是否必须	字段数码
appKey	string	yes	接口appKey，应用的唯一标识
uid	String	Yes	用户标识，唯一且不可变
timestamp	String	Yes	1970-01-01开始的时间戳，毫秒为单位。
sign	String	Yes	MD5签名，参见【签名规则】

响应参数

参数	参数类型	参数说明
success	true/false	是否成功
errorMessage	string	一般为出错原因
data	json	参见‘data明细表’

data明细表

参数	参数类型	是否必传	参数说明
taskId	string	yes	任务id标识
taskName	string	yes	任务名称
taskUrl	string	yes	去完成任务的跳转链接
status	string	yes	任务完成状态: 去完成（false），已完成（success）
type	string	yes	任务类型: 1-普通任务 2-新手任务
credits	string	yes	用户完成任务可获得的积分
subTitle	string	no	任务副标题
targetProgress	string	yes	完成任务所需目标个数
currentProgress	string	yes	当前任务完成个数
iconUrl	string	no	icon图片链接地址
finishedButtonText	string	no	已完成按钮文案
unfinishedButtonText	string	no	未完成按钮文案

响应示例

{
    "success": true,
    "data": [
        {
            "taskId": "2",
            "taskName": "xxx文章评论hmx测试朱标题这里是多少个字体呀看显示是否正常看是否展示2行",
            "status": "success",
            "taskUrl": "http://www.baidu.com",
            "type": "1",
            "credits": "1",
            "subTitle": "副标题hmx测试副标题这里是多少个字体呀看显示是摇一摇常看是否展示1行",
            "targetProgress": "1",
            "currentProgress": "0",
            "iconUrl": "http://yun.duiba.com.cn/h5/activity/custom/winner/8.jpg",
            "finishedButtonText": "我已完成了",
            "unfinishedButtonText": "我还没完成"
        },
        {
            "taskId": "4",
            "taskName": "观看直播",
            "status": "false",
            "taskUrl": "D.duibaOpen(3)",
            "type": "2",
            "credits": "2",
            "subTitle": "已完",
            "targetProgress": "5",
            "currentProgress": "2",
            "iconUrl": "https://yun.dui88.com/for-zhongtai/sceneTest.png",
            "finishedButtonText": "已完成",
            "unfinishedButtonText": "未完成"
        }
    ],
    "errorMessage": "此处写失败原因"
}