组织云钉钉API
  1. 工作通知
组织云钉钉API
  • 服务端API
    • 如何调用服务端API
    • 服务端SDK下载
    • 获取凭证（access_token）
      • 获取企业内部应用的access_token
      • 获取jsapi_ticket
    • 身份验证（免登）
      • 企业内部应用免登
      • 免登常见问题
    • 通讯录管理
      • 通讯录事件
      • 用户管理
        • 创建用户
        • 更新用户信息
        • 删除用户
        • 根据userid获取用户详情
        • 获取部门用户基础信息
        • 获取部门用户userid列表
        • 获取部门用户详情
        • 获取员工人数
        • 获取未登录钉钉的员工列表
        • 根据手机号获取userid
        • 根据unionid获取用户userid
        • 获取管理员列表
        • 获取管理员通讯录权限范围
        • 获取管理员的应用管理权限
      • 部门管理
        • 获取部门详情
        • 获取部门列表
        • 获取子部门ID列表
        • 获取指定部门的所有父部门列表
        • 获取指定用户的所有父部门列表
      • 角色管理
        • 删除角色
        • 创建角色
        • 创建角色组
        • 更新角色
        • 批量增加员工角色
        • 批量删除员工角色
        • 设定角色成员管理范围
        • 获取角色组列表
        • 获取角色列表
        • 获取角色详情
        • 获取指定角色的员工列表
    • 消息通知
      • 消息通知概述
      • 消息类型与数据格式
      • 消息链接说明
      • 工作通知
        • 发送工作通知
          POST
        • 更新工作通知状态栏
          POST
        • 获取工作通知消息的发送进度
          POST
        • 获取工作通知消息的发送结果
          POST
        • 撤回工作通知消息
          POST
      • 普通消息
        • 发送普通消息
  • 钉钉回调相关
    • 钉钉Stream回调
    • 事件订阅列表
  1. 工作通知

获取工作通知消息的发送进度

POST
/topapi/message/corpconversation/getsendprogress
企业内部应用第三方企业应用oapi

说明#

调用本接口获取工作通知消息的发送进度。
服务地址：https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的，在创建应用时，系统已默认添加了消息通知权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是无需申请调试
第三方企业应用是无需申请调试
第三方个人应用否——

请求参数

Query 参数
access_token
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
agent_id
number 
必需
发送消息时使用的微应用的ID。企业内部应用可在开发者后台的应用详情页面查看。第三方企业应用可调用获取企业授权信息接口获取。
task_id
number 
必需
发送消息时钉钉返回的任务ID。仅支持查询24小时内的任务。
示例
{
        "agent_id":123,
        "task_id":456
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/topapi/message/corpconversation/getsendprogress?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "agent_id":123,
        "task_id":456
}'

返回响应

🟢200成功
application/json
Body
request_id
string 
请求ID。
可选
errcode
number 
返回码。
可选
errmsg
string 
返回码描述。
可选
progress
object 
返回结果。
可选
progress_in_percent
number 
可选
取值0~100，表示处理的百分比。
status
number 
可选
任务执行状态：0：未开始1：处理中2：处理完毕
示例
{
    "request_id": "string",
    "errcode": 0,
    "errmsg": "string",
    "progress": {
        "progress_in_percent": 0,
        "status": 0
    }
}
修改于 2023-12-26 06:53:24
上一页
更新工作通知状态栏
下一页
获取工作通知消息的发送结果
Built with