获取工作通知消息的发送结果旧版SDK
更新于 2023-01-05调用本接口,查询工作通知消息的发送结果。
调用本接口,只能获取24小时内工作通知消息的发送结果。
接口调用步骤
步骤一:调用发送工作通知接口获取工作通知任务task_id
。
步骤二:若是没有收到工作通知消息,需要确认工作通知消息发送结果。调用本接口获取工作通知消息的发送结果。
调用接口发送工作通知,当接收人列表超过100人时,不支持调用本接口,否则系统会返回调用超时。
权限
服务端API是以应用维度授权的,在创建应用时,系统已默认添加了消息通知权限。
基本信息
请求方式:POST
请求地址:https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的访问凭证。
|
Body参数
返回参数
名称 | 类型 | 示例值 | 描述 |
send_result | AsyncSendResult | 返回结果。 | |
invalid_user_id_list | String[] | ["manager4220",user123"] | 无效的userId。 |
forbidden_user_id_list | String[] | ["manager4220",user123"] | 因发送消息过于频繁或超量而被流控过滤后实际未发送的userId。 未被限流的接收者仍会被成功发送。 限流规则包括:
|
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。
|
count | Number | 1 | 流控阀值。 |
userid | String | user123 | 被流控员工的userId。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
request_id | String | 6pcvwp6jcows | 请求ID。 |
示例
请求示例(HTTP)
请求正文
请求示例(JAVA SDK)
返回示例
错误码
错误码 | 描述 | 解决方案 |
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 | 超级高管保护 | 关闭高管保护。 |