选择应用类型
第三方企业应用开发

获取工作通知消息的发送结果旧版SDK

更新于 2023-01-05调用本接口,查询工作通知消息的发送结果。

说明

调用本接口,只能获取24小时内工作通知消息的发送结果。

接口调用步骤

步骤一:调用发送工作通知接口获取工作通知任务task_id

步骤二:若是没有收到工作通知消息,需要确认工作通知消息发送结果。调用本接口获取工作通知消息的发送结果。

重要

调用接口发送工作通知,当接收人列表超过100人时,不支持调用本接口,否则系统会返回调用超时

权限

服务端API是以应用维度授权的,在创建应用时,系统已默认添加了消息通知权限。

应用类型

是否支持调用

权限申请方式

API Explorer调试

企业内部应用

支持

默认开通,无需申请

调试

第三方企业应用

支持

默认开通,无需申请

调试

第三方个人应用

暂不支持

基本信息

请求方式:POST

请求地址https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

6d1bxxxx

调用该接口的访问凭证。

Body参数

名称

类型

是否必填

示例值

描述

agent_id

Number

836390886

发送消息时使用的微应用的AgentID。

task_id

Number

256271667526

发送消息时钉钉返回的任务ID。

说明

仅支持查询24小时内的任务。

返回参数

名称

类型

示例值

描述

send_result

AsyncSendResult

返回结果。

invalid_user_id_list

String[]

["manager4220",user123"]

无效的userId。

forbidden_user_id_list

String[]

["manager4220",user123"]

因发送消息过于频繁或超量而被流控过滤后实际未发送的userId。

未被限流的接收者仍会被成功发送。

限流规则包括:

  • 给同一用户发相同内容消息一天仅允许一次。

  • 同一个应用给同一个用户发送消息:

    • 如果是第三方企业接入方式,给同一用户发消息一天不得超过100次。

    • 如果是企业接入方式,此上限为500。

failed_user_id_list

String[]

["manager4220",user123"]

发送失败的userId。

read_user_id_list

String[]

["manager4220",user123"]

已读消息的userId。

unread_user_id_list

String[]

["manager4220",user123"]

未读消息的userId。

invalid_dept_id_list

Number[]

[1,2,3]

无效的部门ID。

forbidden_list

SendForbiddenModel[]

推送被禁止的具体原因。

code

String

143105

流控code。

  • 143105表示企业自建应用每日推送给用户的消息超过上限。

  • 143106表示企业自建应用推送给用户的消息重复。

count

Number

1

流控阀值。

userid

String

user123

被流控员工的userId。

errcode

Number

0

返回码。

errmsg

String

ok

返回码描述。

request_id

String

6pcvwp6jcows

请求ID。

示例

请求示例(HTTP)

Loading...

请求正文

Loading...

请求示例(JAVA SDK)

Loading...

返回示例

Loading...

错误码

错误码

描述

解决方案

143103

企业单应用消息发送人次QPM超限

接口调用太快,稍后重试。

143104

企业每分钟发送人次QPM超限

接口调用太快,稍后重试。

143105

单应用给单人每日推送量超限

企业每天给每个员工最多可发送500条消息通知,ISV最多可发送50条。

143106

单应用给单人推送重复消息超限

给同一员工一天只能发送一条内容相同的消息通知。

143203

ISV单应用发送给单企业人次QPM超限

接口调用太快,稍后重试。

143204

ISV单应用发送给所有企业人次QPM超限

接口调用太快,稍后重试。

143205

单应用给单人每日推送量超限

企业每天给每个员工最多可发送500条消息通知,ISV最多可发送50条。

143206

单应用给单人推送重复消息超限

给同一员工一天只能发送一条内容相同的消息通知。

1430000

接受者为空

接受者不能为空。

1430001

未识别的grantType

无。

1430002

包含违禁内容

检查消息文本中是否有黄色、反动等词语。

1430003

触发OAPI系统保护

无。

1430004

超级高管保护

关闭高管保护。

点击纠错