万店掌 开放平台 修改任务

open.oa.task.modifyTask (修改任务)

修改任务

接口描述#

环境接口方法提交方式是否需要签名HTTP请求路由
正式环境open.oa.task.modifyTaskPOSTtruehttp://cloudapi.ovopark.com/cloud.api

公共请求参数#

参数类型是否必填最大长度描述示例值
_aidString20开放平台系统编号,固定为S107S107
_akeyString20万店掌开放平台分配给第三方的开发者key认证平台开发者后获取
_mtString100接口名称open.oa.task.modifyTask
_smString100签名算法 md5,sha1md5
_requestModeString100请求方式post,getPOST
_versionString100版本号v1
_timestampString100时间戳yyyyMMddHHmmss格式
_sigString32签名token根据签名算法生成,详情见签名算法规则
_formatString10format类型目前默认仅支持json

业务请求参数#

参数类型是否必填最大长度描述示例值
taskVoJson
string11请求入参方式application/x-www-form-urlencoded{ "executors": [ ], "taskDeps": [ 87846, 87847 ], "taskName": "任务参数", "inspectorIds": [ 512174639 ], "ccpersonIds": [ 512535874 ], "executorSelectType": 4, "importance": 0, "remark": "任务描述", "richRemark": "", "startTime": "2024-11-28 00:00:00", "endTime": "2024-11-29 23:59:59", "attachments": [ { "attachNames": "", "attachmentUrls": "" } ], "executionDetails": [ { "remark": "明细222", "urlList": [ ], "id": 53597, "deleted": 0, "attachLimit": 2, "attachMaxLimit": 50, "notifyType": 0, "sort": 1 }, { "remark": "明细1", "urlList": [ ], "attachLimit": 1, "attachMaxLimit": 50, "notifyType": 0, "appointNotifyTimes":"", "pointInTimes":"", "sort": 1 , "deleted": 1 }, { "remark": "明细2", "urlList": [ "g" ], "attachLimit": 2, "attachMaxLimit": 50, "notifyType": 0, "sort": 2 } ], "isExecutionDetail": 1, "enableAI": false, "AIModel": "", "thirdPartyId": null, "lableId": "17261", "attachLimit": 1, "attachMaxLimit": 50, "enableDetailComment": false, "enableRealtimeShooting": true, "notifies": [ { "notifyType": 1, "duration": 30 } ], "startOfNotifies": [ { "notifyType": -1, "duration": 30, "notifyObjects": "1,2,3,0" } ], "expireNotify": { "remindInspector": false, "remindCc": true, "appointUsers":"" }, "isConfigure": 1, "enableReject": 1, "taskAttach": [ { "url": "hpg", "isPicture": 1, "isVideo": 0 } ], "taskId": 87172 }
×
    
executors
JSON×0执行人员ID数组(人员模式传值)查看
    
taskName
string×0任务参数
    
inspectorIds
JSON×0抄送人员ID数组查看
    
executorSelectType
int×0 执行人员选择类型 1指定人员 4指定门店
    
importance
int×0优先级, 0最低级 5最高级
    
remark
string×0任务描述, &richRemark只能二选一生效
    
richRemark
string×0 富文本描述
    
startTime
int×0任务开始时间 未开始任务支持修改;非未开始状态的任务禁止修改
    
endTime
int×0任务结束时间 修改的时间需大于当前时间
    
attachments
JSON0[ // 任务附件 { "attachNames": "15587209_ovopark.com_nginx.zip", // 附件名称 "attachmentUrls": "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/15587209_ovopark-1732684719800.zip"// 附件地址URL } ]查看
    
executionDetails
string0集合格式 [ // 执行明细 { // 1、修改明细id必传,deleted= 0 "remark": "明细222", "urlList": [ "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/e6ivwRE0PoiDAFW.png" ], "id": 53597, "deleted": 0, "attachLimit": 2, "attachMaxLimit": 50, "notifyType": 0, "sort": 1 } { // 2、删除明细 "remark": "明细1", // 明细描述 "urlList": [ // 明细图片地址URL "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/9QBuqAKIuwStZuV.png", "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/6y6O40YTC0UEwC2.jpg" ], "attachLimit": 1, // 上传最小数量 "attachMaxLimit": 50,// 最大上传数量 "notifyType": 0, //通知类型,0 不提醒,1每天按照时间点提醒 取pointInTimes 2 指定时间提醒 取appointNotifyTimes "appointNotifyTimes":"",//指定时间,String 格式(yyyy-MM-dd HH:mm:ss),多个英文逗号分隔(目前支持一个即可) "pointInTimes":"",//指定时间点,String 格式(HH:mm:ss),多个英文逗号分隔(目前支持一个即可) "sort": 1// 明细排序, "id": 53596, // 修改明细对应的ID "deleted": 1, // 是否删除 }, { // 3、新增明细,id 和deleted不需要 "remark": "明细2", "urlList": [ "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/e6ivwRE0PoiDAFW.png" ], "attachLimit": 2, "attachMaxLimit": 50, "notifyType": 0, "sort": 2 } ]
    
isExecutionDetail
int×0是否明细任务,1是,0非明细任务,明细任务executionDetails必传
    
enableAI
boolean×0是否AI识别任务,开通需要联系产品
    
lableId
string×0标签ID,多个英文逗号分隔
    
attachLimit
int×0非明细任务最小上传数量
    
attachMaxLimit
int×0 非明细任务最大上传数量
    
enableDetailComment
boolean×0// 是否开启开启明细评论,isExecutionDetail = 1生效,如果开启明细评论,则不允许统一评论,默认统一评论。
    
enableRealtimeShooting
boolean×0是否开启实时拍摄,默认空,空或false不限制
    
notifies
int×0// 到期前提醒 [ // 到期前提醒 { "notifyType": 1,// 通知类型,1:分钟前,2:小时前,3 天 "duration": 30 //具体时长,分钟或者小时、天 } ], "startOfNotifies": [ // 开始前提醒 { "notifyType": -1,// 开始前通知类型,-1:分钟前,-2:小时前,-3 天 "duration": 30,//具体时长,分钟或者小时、天 "notifyObjects": "1,2,3,0" //通知对象 0 创建人,1执行人 2 审核人 3 抄送人 ,多个英文逗号分隔 } ], "expireNotify": { // 到期后未执行情况提醒。 overdueTaskDefaultClose=0 可配置生效 "remindInspector": false, // 提醒审核人 "remindCc": true, // 提醒抄送人 "appointUsers":"[{"userId":512504938,"userName":"geyang"},{"userId":512520033,"userName":"geyangcs"}]" // 提醒指定人,需要用户ID,用户名。限制任务20人 }, "isConfigure": 1,// 是否要上传照片/视频 "enableReject": 1, "taskAttach": [ // 任务图片/视频 { "url": "https://ovopark-oss-dev.oss-cn-hangzhou.aliyuncs.com/oa-task/1084/web/2024/11/27/SC7XjAQkJVEe2qs.jpg", // 图片地址URL "isPicture": 1, //图片1 "isVideo": 0 // 视频1 } ]
    
taskDeps
int0// 执行门店ID数组(门店模式传值)
    
taskId
int0taskId

公共响应参数#

参数类型最大长度描述示例值
statJSON-网关状态(具体参数描述如下:)查看
stat.cidString100http请求的标识符
stat.codeString100网关返回码
stat.codenameString100网关返回码名称
stat.systimeStringLong接口调用的当前时间
resultString100接口返回提示信息
dataJSON-接口调用返回的业务信息(一般是json格式数据,具体数据格式会在业务返回参数中定义)查看

业务返回参数#

参数名称类型是否一定返回返回最大长度描述示例值
data
JSON×11返回查看

公共返回码#

返回码名称返回码返回码描述解决方案
SUCCESS0调用成功
KEY_NOTNULL1_akey和不能为空接口调用时传入_akey参数
KEY_UNLAWFUL2_akey不合法key是非法的,传入正确的key
KEY_HAS_EXPIRED3_akey已过期请续订服务或联系平台管理人员
SIGN_METHOD_NOTNULL4_sm参数不能为空接口调用时传入_sm参数
SIGN_TYPE_NOTEXIST5_sm类型不存在目前仅支持md5,sha1
SIGN_NOTNULL6_sig参数不能为空接口调用时传入_sig参数
SIGN_WRONG7无效的签名,请检查参数和签名格式_sig值根据签名算法生成
METHOD_NOTNULL8_mt参数不能为空接口调用时传入_mt参数
METHOD_NOTEXIST_CODE9_mt对应的方法名不存在或未注册进服务检查_mt方法名和_version版本号对应的方法是否传入错误
REQUESTMODE_NOTNULL10_requestMode参数不能为空接口调用时传入_requestMode参数
APPLICATIONID_NOTNULL11_aid参数不能为空接口调用时传入_aid参数
APPLICATIONID_NOTSAME12_aid与当前key不匹配_aid与_akey必须一一对应
VERSION_NOTNULL13_version版本号不能为空接口调用时传入_version参数
TIMESTAMP_NOTNULL14_timestamp时间戳不能为空接口调用时传入_timestamp参数
TIMESTAMP_FORMAT_ERROR15_timestamp时间戳格式化错误按照yyyyMMddHHmmss格式
TIMESTAMP_OVERTIME16_timestamp已失效_timestamp每次接口调用时重新生成
FORMAT_TYPE_NOTEXIST17_format类型不存在目前仅支持json(默认),xml
API_CALL_REPEAT-100接口重复调用接口平台调用异常
API_SYSTEM_CALL_ERROR-500api调用失败,系统发生异常接口平台调用异常
UNKNOWN_ERROR-999开放平台系统异常重新发起请求

业务返回码#

返回码名称返回码返回码描述
code
0success