更新时间:2022-12-29 GMT+08:00
分享

新增待办任务

功能介绍

用于集成WeLink待办,在待办模块展示用户待处理的任务事项入口和用户发起的申请单入口。

接口约束

调试

您可以在API Explorer中调试该接口。

URL

POST https://open.welink.huaweicloud.com/api/todo/v2/addtask

请求消息

请求头部见表1

表1请求头部

参数

是否必选

参数类型

描述(值)

x-wlk-Authorization

String

access_token

Content-Type

String

application/json

请求参数见表2

表2请求参数

参数

是否必选

参数类型

说明

taskId

String

租户应用任务id

taskTitle

String

待办任务标题

userId

String

待办任务的当前处理人账号

userNameCn

String

待办任务的当前处理人中文名字

userNameEn

String

待办任务的当前处理人英文名字

detailsUrl

String

待办详情查看路径

appName

String

应用名称

applicantUserId

String

任务申请人id

applicantUserNameCn

String

任务申请人中文名字

applicantUserNameEn

String

任务申请人英文名字

isMsg

Int

是否发送消息通知。传0表示不发送消息,传1表示发送公众号消息,默认为0

isShowApplicantUserName

Boolean

是否显示申请人。传true表示展示申请人,传false表示不展示申请人,默认为true

applicantId

String

申请ID,同一条申请,需同时推送给多人,则该值相同

响应消息

正常返回结果:

{
  "code": "0",
  "message": "新增待办任务成功!",
  "data": {
            "taskId": "202008fangiia",
            "taskTitle": "周五上午请假",
            "userId": "zhangsan@dd",
            "userNameCn":"张三",
            "userNameEn":"zhangsan",
            "detailsUrl": "https://welink.example.cn/todo/v1/appList",
            "appName": "请假申请",
            "taskDesc": "周五上午请假",
            "applicantUserId": "lisi@dd",
            "applicantUserNameCn": "李四",
            "applicantUserNameEn": "lisi",
            "isMsg":1,
            "isShowApplicantUserName":true,
           "applicantId":"202008fangjia1"
  }
}

请求示例

  • 请求参数示例
{
    "taskId": "202008fangiia",
    "taskTitle": "周五上午请假",
    "userId": "zhangsan@dd",
    "userNameCn":"张三",
    "userNameEn":"zhangsan",
    "detailsUrl": "https://example.com/app/detail/5",
    "appName": "请假",
    "applicantUserId": "lisi@dd",
    "applicantUserNameCn": "李四",
    "applicantUserNameEn": "lisi",
    "isMsg": 1,
    "isShowApplicantUserName":true,
    "applicantId":"202008fangjia1"
}
  • 请求URL示例
curl -X POST
  'https://open.welink.huaweicloud.com/api/todo/v2/addtask' 
  -H 'Accept-Charset: UTF-8' 
  -H 'Content-Type: application/json' 
  -H 'x-wlk-Authorization: access_token' 
  -d '{"请求参数 json格式"}'

返回值

返回参数说明:

参数

必选

参数类型

说明

code

String

数据正常返回“0”,如果发生错误,会返回对应的错误码

message

String

返回信息,包括接口请求发生错误时的详细信息

data

Object

调用成功时表示调用结果,详见data数据结构。

data 数据结构

参数

必选

参数类型

说明

taskId

String

租户应用任务id

taskTitle

String

审批任务标题。

userId

String

任务的当前处理人的账号id

userNameCn

String

任务的当前处理人的中文名字

userNameEn

String

任务的当前处理人的英文名字

appName

String

应用名称

detailsUrl

String

待办详情查看路径

applicantUserId

String

申请人账号id

applicantUserNameCn

String

申请人中文名字

applicantUserNameEn

String

申请人英文名称

isShowApplicantUserName

Boolean

申请人显示标识

isMsg

Int

发送消息通知标识

applicantId

String

申请ID,同一条申请,推送多人,该值相同

错误码

错误码

说明

0

成功

55002

没有操作权限

55012

认证服务异常

55014

token认证失败

55010

待办ID已存在

55015

申请ID已存在

分享:

    相关文档

    相关产品