橙讯开放平台基线
首页服务端API客户端API附录橙讯官网
首页服务端API客户端API附录橙讯官网
  1. 待办
  • 开发前准备
  • 组织自建应用对接
    • 获取访问凭证
      • 获取访问凭证
    • 单点登录
      • 概述
      • 应用单点登录
      • 管理员单点登录
    • 消息推送
      • 概述
      • 消息推送
      • 消息撤回
    • 通讯录同步
      • 概述
      • 获取通讯录
        • 获取全量通讯录
        • 获取增量通讯录
      • 回调通知
        • 回调通知说明
    • 机器人
      • 概述
      • 创建群
      • 更新群
      • 查询群信息
      • 解散群
      • 设置群公告
      • 查询机器人创建的群列表
      • 发送群消息
      • 给指定用户发送消息
    • 待办
      • 概述
      • 创建待办
        POST
      • 更新待办
        PUT
      • 删除待办
        DELETE
      • 更新待办执行人
        PUT
    • 待阅
      • 概述
      • 创建待阅
      • 更新待阅
      • 删除待阅
      • 更新待阅执行人
    • 工作台卡片
      • 概述
      • 添加应用卡片模板
      • 获取应用的卡片模板列表
      • 更新应用卡片模板
      • 删除应用卡片模板
      • 设置卡片组织级数据
      • 批量设置卡片数据(卡片数据不同)
      • 批量设置卡片数据(卡片数据相同)
    • 错误码
      • 错误码
  • 组织服务对接
    • 组织服务对接准备
    • 对接流程
      • 概述
      • 换取企业永久授权码
      • 获取访问凭证
      • 获取全量通讯录
      • 获取增量通讯录变更
      • 更新通讯录
    • 错误码
      • 错误码
  • 历史版本(不推荐)
    • 组织自建应用对接
      • 通讯录同步
        • 概述
        • 获取通讯录
          • 获取全量通讯录
          • 获取增量通讯录
        • 回调通知
          • 回调通知说明
      • 消息推送
        • 概述
        • 消息推送
  1. 待办

更新待办

PUT
/apps/v1/to-do/{id}
接口描述:企业应用在开启统一待办功能后可以通过接口修改待办。
请求地址:https://service.cheng-xun.cn/api/apps/v1/to-do/{id}?access_token={access_token}
请求方式:PUT#

请求参数

Authorization
Path 参数
id
string 
必需
三方应用指定的待办id
Query 参数
access_token
string 
应用的访问凭证
必需
Header 参数
User-Agent
string 
可选
默认值:
CX
Body 参数application/json
待办信息
title
string 
标题
可选
待办标题,null 即为不修改
description
string 
详情
可选
待办详情,换行使用\n表示,null 即为不修改
status
string 
状态
可选
可以通过该参数设置整个待办的完成状态,IN_PROGRESS 待办,DONE 已完成,null 即为不修改
jump_action
string 
跳转参数
可选
待办通知跳转参数,null 即为不修改
end_time
string 
结束时间
可选
需包含时区,格式"yyyy-MM-dd HH:mm:ss Z",例如"2024-07-10 08:00:00 +0800",null 即为不修改
remind_time
string 
提醒时间
可选
需包含时区,格式"yyyy-MM-dd HH:mm:ss Z",例如"2024-07-10 08:00:00 +0800",如果结束时间不为空,则不得晚于结束时间,null 即为不修改
executor_ids
array[string]
执行人ID列表
可选
执行人 account id 列表,不得为空列表,最多支持1000人,null 即为不修改
示例
{
    "title": "string",
    "description": "string",
    "status": "string",
    "jump_action": "string",
    "end_time": "string",
    "remind_time": "string",
    "executor_ids": [
        "string"
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://service.cheng-xun.cn/api/apps/v1/to-do/?access_token' \
--header 'User-Agent: CX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "string",
    "description": "string",
    "status": "string",
    "jump_action": "string",
    "end_time": "string",
    "remind_time": "string",
    "executor_ids": [
        "string"
    ]
}'

返回响应

🟢200成功
application/json
Body
com.westone.aac.dto.thirdapp.ThirdAppResponseDTO
err_code
integer 
可选
err_msg
string 
可选
默认值:
ErrorCode.SUCCESS.getErrMsg()
示例
{
  "errCode": 0,
  "errMsg": ""
}
修改于 2025-04-01 02:36:03
上一页
创建待办
下一页
删除待办
Built with