Codex
2.1 KiB
2.1 KiB
2026-06-25 M08-B 保洁端 API
App API
-
GET /app-api/cleaning/tasks/hall- 登录：必需。
- 权限：
cleaning.task.read、tenant.manage或PLATFORM_ADMIN。 - 查询：
page、pageSize、status；默认查询WAITING。 - 说明：按保洁员门店范围返回任务大厅。
-
GET /app-api/cleaning/tasks/mine- 登录：必需。
- 权限：
cleaning.task.read、tenant.manage或PLATFORM_ADMIN。 - 查询：
page、pageSize、status。 - 说明：返回当前保洁员已领取任务。
-
POST /app-api/cleaning/tasks/:taskId/claim- 登录：必需。
- 权限：
cleaning.task.write、tenant.manage或PLATFORM_ADMIN。 - 说明：仅
WAITING且未被领取的任务可接单。
-
POST /app-api/cleaning/tasks/:taskId/start- 登录：必需。
- 权限：
cleaning.task.write、tenant.manage或PLATFORM_ADMIN。 - 说明：当前保洁员已领取的
CLAIMED任务可开始。
-
POST /app-api/cleaning/tasks/:taskId/photos- 登录：必需。
- 权限：
cleaning.task.write、tenant.manage或PLATFORM_ADMIN。 - Content-Type：
application/octet-stream。 - Headers：
x-file-name、x-image-content-type。 - 说明：当前保洁员本人
STARTED或REJECTED任务可上传验收照片；服务端压缩存储后返回publicUrl。
-
POST /app-api/cleaning/tasks/:taskId/submit- 登录：必需。
- 权限：
cleaning.task.write、tenant.manage或PLATFORM_ADMIN。 - Body：
photoUrls: string[]，note?: string。 - 说明：当前保洁员本人
STARTED或REJECTED任务可提交验收；photoUrls至少 1 张，最多 9 张。
-
POST /app-api/cleaning/tasks/:taskId/rework- 登录：必需。
- 权限：
cleaning.task.write、tenant.manage或PLATFORM_ADMIN。 - 说明：当前保洁员本人
REJECTED任务可重新进入STARTED补做状态。
-
GET /app-api/cleaning/stats- 登录：必需。
- 权限：
cleaning.task.read、tenant.manage或PLATFORM_ADMIN。 - 说明：返回当前保洁员任务状态计数和待结算金额。