dingtalk.corp.ding.task.create (ding任务创建接口)

ding任务创建。不过会有一些限制,只能发送文本任务,不能设置抄送人,只能有一个任务执行人。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
task_send_v_o TaskSendVo 必须 任务对外接口
  • └ send_userid
  • String
  • 必须
  • B0E30163205DBF474CE3DD89355FDB51
  • 发送者ID
  • └ content_type
  • Number
  • 必须
  • 1
  • 任务内容类型;1-文本;目前只支持文本;
  • └ content
  • String
  • 必须
  • 下午3点开会
  • 任务内容
  • └ remind_type
  • Number
  • 必须
  • 1
  • 提醒方式;1-应用内;目前只支持应用内;
  • └ remind_time
  • Number
  • 可选
  • 100022220992
  • 提醒时间(单位:毫秒),datetime转成long
  • └ receiver_userid
  • String
  • 必须
  • ABC21DEEE
  • 任务执行人
  • └ dead_line
  • Number
  • 必须
  • 100022220992
  • 任务截止时间(单位:毫秒),datetime转成long

响应参数

名称 类型 示例值 描述
result DingOpenResult - result
  • └ success
  • Boolean
  • true
  • success
  • └ ding_open_errcode
  • Number
  • -1
  • dingOpenErrcode
  • └ error_msg
  • String
  • 系统异常
  • errorMsg
  • result
  • TaskSendResult
  • -
  • result
  • └ ding_id
  • String
  • B0E30163205DBF474CE3DD89355FDB51
  • dingId

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
CorpDingTaskCreateRequest req = new CorpDingTaskCreateRequest();
TaskSendVo obj1 = new TaskSendVo();
obj1.setSendUserid("B0E30163205DBF474CE3DD89355FDB51");
obj1.setContentType(1L);
obj1.setContent("下午3点开会");
obj1.setRemindType(1L);
obj1.setRemindTime(100022220992L);
obj1.setReceiverUserid("ABC21DEEE");
obj1.setDeadLine(100022220992L);
req.setTaskSendVO(obj1);
CorpDingTaskCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<dingtalk_corp_ding_task_create_response>
    <result>
        <success>true</success>
        <ding_open_errcode>-1</ding_open_errcode>
        <error_msg>系统异常</error_msg>
        <result>
            <ding_id>B0E30163205DBF474CE3DD89355FDB51</ding_id>
        </result>
    </result>
</dingtalk_corp_ding_task_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部