查看源

接口说明

请求URI

/editorPlugin/task/getTaskDetail

功能描述

任务事件回调-查任务详情

注意事项

注意：获取任务详情，注：如果有传audid/openId/unionid，则taskRecordList只返回指定用户的任务记录，否则返回全部用户的任务记录

调用方式

HTTPS 调用


GET https://integrate.rabbitpre.com/api/open/editorPlugin/task/getTaskDetail

请求数据类型

[ "application/json" ]

响应数据类型

[ "application/json" ]

请求头参数

属性	类型	必填	说明
X-Token	string	是	自建应用访问token

请求体参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
appInstanceId	应用实例ID	query	false	integer(int64)
nonce	6位随机字符串	query	true	string
timestamp	unix时间戳(毫秒)	query	true	integer(int64)
orgId	企业ID	query	false	string
appId	作品id	query	true	string
taskId	任务id	query	true	string	任务id可以通过获取作品的玩法接口获取：https://docs.tuzhanai.com/pages/viewpage.action?pageId=1938720 组件名称是任务的，componentId就是任务id （前端生成的）
audid	客户id (查询用户任务记录条件之一)	query	false	string
unionid	wx unionid(查询用户任务记录条件之一)	query	false	string
openId	wx openid(查询用户任务记录条件之一)	query	false	string

响应参数

参数名称	参数说明	类型	schema
code	返回码	string
errorCode	错误码	string
msg	返回信息	string
data	返回数据	object	TaskDetailDto

响应示例

{
  "code": "200",
  "errorCode": "SUCCESS",
  "msg": "ok",
  "data": {
    "taskId": "",
    "title": "",
    "taskSign": "",
    "preFlag": 0,
    "taskType": 0,
    "taskPartakeType": 0,
    "appId": "",
    "appTitle": "",
    "appUrl": "",
    "taskRecordList": [
      {
        "taskRecordId": ,
        "taskStauts": 0,
        "userInfo": {
          "audid": "",
          "nickName": "",
          "openId": "",
          "unionid": ""
        }
      }
    ],
   "taskTimeConfigDto": {
         "resetTaskInterval": "",
         "intervalHour": 0
    }   
  }
}

响应schema属性说明

TaskDetailDto

参数名称	参数说明	类型
taskId	任务id	string
title	任务标题	string
taskSign	任务标识	string
preFlag	是否前置任务.0:不是,1:是	byte
taskType	任务场景.0:线上,1:线下,统一归属为接口回调类型\| 2 事件类型	byte
taskPartakeType	任务参与页面类型默认为1-线上 2-线下	integer
appId	作品id	string
appTitle	作品标题	string
appUrl	作品链接	string
taskRecordList	任务记录列表	ArrayList<TaskRecordDto>
taskTimeConfigDto	任务轮询周期设置	TaskTimeConfigDto

TaskTimeConfigDto

参数名称	参数说明	类型
resetTaskInterval	任务重置时间类型 custom/week/activity/day 自定义每周活动期间每天	string
intervalHour	任务刷新时间间隔	integer


TaskRecordDto

参数名称	参数说明	类型	schema
参数名称	参数说明	类型	schema
taskRecordId	任务记录id	integer
taskStatus	任务状态： 0:未完成.10:任务已经完成,待领取奖品.30:任务流程全部完成	byte
UserInfo	用户信息	object


UserInfo

参数名称	参数说明	类型
audid	客户id	integer(int64)
openId	微信openId	string
unionid	微信unionid	string
nickName	微信昵称	string

错误码

错误码	错误码取值	解决方案
200	Success
401	Unauthorized
403	Forbidden
404	Not Found