open.shopweb.liveCheck.getProblemList （分页获取待办单）
分页获取待办单
接口描述#
| 环境 | 接口方法 | 提交方式 | 是否需要签名 | HTTP请求路由 |
|---|---|---|---|---|
| 正式环境 | open.shopweb.liveCheck.getProblemList | POST | true | http://cloudapi.ovopark.com/cloud.api |
公共请求参数#
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| _aid | String | 是 | 20 | 开放平台系统编号，固定为S107 | S107 |
| _akey | String | 是 | 20 | 万店掌开放平台分配给第三方的开发者key | 认证平台开发者后获取 |
| _mt | String | 是 | 100 | 接口名称 | open.shopweb.liveCheck.getProblemList |
| _sm | String | 是 | 100 | 签名算法 md5,sha1 | md5 |
| _requestMode | String | 是 | 100 | 请求方式post,get | POST |
| _version | String | 是 | 100 | 版本号 | v1 |
| _timestamp | String | 是 | 100 | 时间戳 | yyyyMMddHHmmss格式 |
| _sig | String | 是 | 32 | 签名token | 根据签名算法生成，详情见签名算法规则 |
| _format | String | 否 | 10 | format类型 | 目前默认仅支持json |
业务请求参数#
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| pageNumber | int | √ | 10 | 页码 | 1 |
| pageSize | int | √ | 10 | 页长 | 10 |
| startTime | string | √ | 10 | 开始时间 | 2022-12-13 00:22:00 |
| endTime | string | √ | 10 | 结束时间 | 2022-12-13 11:22:00 |
公共响应参数#
| 参数 | 类型 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|
| stat | JSON | - | 网关状态(具体参数描述如下：) | 查看 |
| stat.cid | String | 100 | http请求的标识符 | |
| stat.code | String | 100 | 网关返回码 | |
| stat.codename | String | 100 | 网关返回码名称 | |
| stat.systime | String | Long | 接口调用的当前时间 | |
| result | String | 100 | 接口返回提示信息 | |
| data | JSON | - | 接口调用返回的业务信息(一般是json格式数据，具体数据格式会在业务返回参数中定义) | 查看 |
业务返回参数#
| 参数名称 | 类型 | 是否一定返回 | 返回最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| data | JSON | × | 10 | 业务返回信息 | 查看 |
| id | int | × | 10 | 问题（待办单）id | 58418 |
| problemName | string | × | 0 | 问题名（点检项名称） | 公共卫生 |
| description | string | × | 0 | 问题描述 | 6月21号12:22分过道卫生不干净 |
| pictureUrl | string | × | 0 | 封面图片 | url |
| pictureUrls | JSON | × | 0 | 问题图片地址集 | 查看 |
| reformPictureUrls | JSON | × | 0 | 整改后的图片地址集 | 查看 |
| sourceType | int | × | 0 | 问题来源 | 1点检 2摇一摇 3图片抓拍 4手动创建 5在线考评 6快拍 7告警 8现场巡店 9远程巡店 10抓拍比对 11 实时监控 12 门店自检 13巡店任务 -远程巡店 14巡店任务 -现场巡店 15 巡检计划 16 店探 17巡店任务 -门店自检 |
| createrId | int | × | 0 | 创建人id | 512474428 |
| status | int | × | 0 | 问题（待办单）状态 | 3待复检 4整改完成 5待整改 2不合格（AI） -3 待审批 -4 申诉通过 -6 申诉不通过 -5 待申诉 7 问题过期 |
| createTimeShow | string | × | 0 | 创建日期 | 2022-06-01 |
| endTime | string | × | 0 | 到期时间 | 2022-06-04 |
| rectifyTime | string | × | 0 | 整改时间 | 2022-06-04 |
| shopId | string | × | 0 | 第三方门店id | 520 |
| deptName | string | × | 0 | 门店名称 | 苏州总部演示门店 |
| handlerId | int | × | 0 | 整改人id | 22266 |
| toUserId | int | × | 0 | 当前处理人id | 22256 |
| evaluationScore | double | × | 0 | 标准分 | 5 |
| score | double | × | 0 | 得分 | 3 |
| copyUsers | string | × | 0 | 是否需要整改 | 0 需要 1 不需要 |
| isReformed | int | × | 0 | 待办单流程 | 0其他流程 1 申诉整改流程 |
| taskSubmitHistoryId | int | × | 0 | 任务记录id | 与任务列表taskSubmitHistoryId关联 |
公共返回码#
| 返回码名称 | 返回码 | 返回码描述 | 解决方案 |
|---|---|---|---|
| SUCCESS | 0 | 调用成功 | |
| KEY_NOTNULL | 1 | _akey和不能为空 | 接口调用时传入_akey参数 |
| KEY_UNLAWFUL | 2 | _akey不合法 | key是非法的,传入正确的key |
| KEY_HAS_EXPIRED | 3 | _akey已过期 | 请续订服务或联系平台管理人员 |
| SIGN_METHOD_NOTNULL | 4 | _sm参数不能为空 | 接口调用时传入_sm参数 |
| SIGN_TYPE_NOTEXIST | 5 | _sm类型不存在 | 目前仅支持md5,sha1 |
| SIGN_NOTNULL | 6 | _sig参数不能为空 | 接口调用时传入_sig参数 |
| SIGN_WRONG | 7 | 无效的签名，请检查参数和签名格式 | _sig值根据签名算法生成 |
| METHOD_NOTNULL | 8 | _mt参数不能为空 | 接口调用时传入_mt参数 |
| METHOD_NOTEXIST_CODE | 9 | _mt对应的方法名不存在或未注册进服务 | 检查_mt方法名和_version版本号对应的方法是否传入错误 |
| REQUESTMODE_NOTNULL | 10 | _requestMode参数不能为空 | 接口调用时传入_requestMode参数 |
| APPLICATIONID_NOTNULL | 11 | _aid参数不能为空 | 接口调用时传入_aid参数 |
| APPLICATIONID_NOTSAME | 12 | _aid与当前key不匹配 | _aid与_akey必须一一对应 |
| VERSION_NOTNULL | 13 | _version版本号不能为空 | 接口调用时传入_version参数 |
| TIMESTAMP_NOTNULL | 14 | _timestamp时间戳不能为空 | 接口调用时传入_timestamp参数 |
| TIMESTAMP_FORMAT_ERROR | 15 | _timestamp时间戳格式化错误 | 按照yyyyMMddHHmmss格式 |
| TIMESTAMP_OVERTIME | 16 | _timestamp已失效 | _timestamp每次接口调用时重新生成 |
| FORMAT_TYPE_NOTEXIST | 17 | _format类型不存在 | 目前仅支持json(默认),xml |
| API_CALL_REPEAT | -100 | 接口重复调用 | 接口平台调用异常 |
| API_SYSTEM_CALL_ERROR | -500 | api调用失败，系统发生异常 | 接口平台调用异常 |
| UNKNOWN_ERROR | -999 | 开放平台系统异常 | 重新发起请求 |
业务返回码#
| 返回码名称 | 返回码 | 返回码描述 |
|---|---|---|
| code | 0 | 成功 |