跳到主要内容

新手任务 (newbie)

此模块负责新手任务与破土计划的进度、奖励与过期检测。


所有 action 均需登录(依赖 cloud.getWXContext().OPENID)。


1. 获取新手任务列表 [GET]

接口描述:获取当前用户新手任务列表,含任务状态、奖励等。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)getNewbieTasks

1.1 请求参数 (Parameters)

无。

1.2 响应数据 (Response)

成功时返回任务列表及完成状态,见 README 2.2 通用约定。

1.3 错误码 (Error Codes)

通用报错码。未登录时为 RH00001。

1.4 示例 (Examples)

{
"action": "getNewbieTasks",
"data": {}
}

2. 检测并发放任务奖励 [POST]

接口描述:当任务完成条件满足时,检测并发放任务奖励。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)checkAndAwardTask

2.1 请求参数 (Parameters)

见通用约定(如 taskId 或由业务自动检测)。

2.2 响应数据 (Response)

见通用约定。

2.3 错误码 (Error Codes)

通用报错码

2.4 示例 (Examples)

{
"action": "checkAndAwardTask",
"data": {}
}

3. 检查任务过期 [POST]

接口描述:检查新手任务是否过期,可由定时任务或进入页时调用。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)checkTaskExpiration

3.1 请求参数 (Parameters)

见通用约定。

3.2 响应数据 (Response)

见通用约定。

3.3 错误码 (Error Codes)

通用报错码

3.4 示例 (Examples)

{
"action": "checkTaskExpiration",
"data": {}
}

4. 获取破土计划进度 [GET]

接口描述:获取破土计划进度,可传 role(租户/商家)。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)getBreakthroughProgress

4.1 请求参数 (Parameters)

参数名类型必选默认值描述示例
roleString-角色:租户/商家“lessee”

4.2 响应数据 (Response)

见通用约定。

4.3 错误码 (Error Codes)

通用报错码

4.4 示例 (Examples)

{
"action": "getBreakthroughProgress",
"data": { "role": "lessee" }
}

5. 检测破土是否完成 [POST]

接口描述:检测破土计划是否达成(如完成 3 单等)。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)checkBreakthroughCompletion

5.1 请求参数 (Parameters)

见通用约定。

5.2 响应数据 (Response)

见通用约定。

5.3 错误码 (Error Codes)

通用报错码

5.4 示例 (Examples)

{
"action": "checkBreakthroughCompletion",
"data": {}
}

6. 处理破土失败 [POST]

接口描述:处理破土计划失败(超时、中断等)。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)handleBreakthroughFailure

6.1 请求参数 (Parameters)

见通用约定。

6.2 响应数据 (Response)

见通用约定。

6.3 错误码 (Error Codes)

通用报错码

6.4 示例 (Examples)

{
"action": "handleBreakthroughFailure",
"data": {}
}

7. 检查破土计划是否过期 [POST]

接口描述:检查破土计划是否过期(如 90 天未完成)。

项目说明
云函数名newbie
HTTP 路由不适用
动作类型 (Action)checkBreakthroughExpiration

7.1 请求参数 (Parameters)

见通用约定。

7.2 响应数据 (Response)

见通用约定。

7.3 错误码 (Error Codes)

通用报错码

7.4 示例 (Examples)

{
"action": "checkBreakthroughExpiration",
"data": {}
}