获取推送失败的事件列表.md 6.7 KB
获取推送失败的事件列表旧版SDK
更新于 2026-05-08调用本接口获取推送失败的变更事件。钉钉服务器给回调地址推送数据时，有可能因为各种原因推送失败（例如网络异常），此时钉钉将保留此次变更事件。
接口调用说明
事件订阅推送失败，会进行重新推送，重试规则如下：
| 第几次重试 | 与上次重试时间间隔 |
|---|---|
| 1 | 10秒 |
| 2 | 30秒 |
例如：事件第一次推送失败后，经过10秒，进行第一次重试，直至第 2 次重试失败后，可在3～5分钟内通过本接口获取推送失败的事件列表。
请求
| 基本信息 | 基本信息 |
|---|---|
| HTTP URL | https://oapi.dingtalk.com/call_back/get_call_back_failed_result |
| HTTP Method | GET |
| 支持的应用类型 | 企业内部应用第三方企业应用 |
| 权限要求 | 调用企业API时需要具备的基本权限 |
查询参数
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 577bfxxxx473f99d40c | 调用服务端API的应用凭证。 |
企业内部应用，通过获取企业内部应用的access_token接口获取。
第三方企业应用，通过获取第三方应用授权企业的access_token接口获取。 |
请求示例
curl
1
2
3
curl -X GET "https://oapi.dingtalk.com/call_back/get_call_back_failed_result" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=577bfxxxx473f99d40c'
Enter to Rename, ⇧Enter to Preview
Java
1
DingTalkClient client \= new DefaultDingTalkClient("https://oapi.dingtalk.com/call_back/get_call_back_failed_result");
Enter to Rename, ⇧Enter to Preview
Python
1
# -*- coding: utf-8 -*-
Enter to Rename, ⇧Enter to Preview
PHP
1
include "TopSdk.php";
Enter to Rename, ⇧Enter to Preview
Node.js
1
let { Config, OapiCallBackGetCallBackFailedResultParams, OapiCallBackGetCallBackFailedResultRequest } = require('./client.js');
Enter to Rename, ⇧Enter to Preview
C#
1
IDingTalkClient client \= new DefaultDingTalkClient("https://oapi.dingtalk.com/call_back/get_call_back_failed_result");
Enter to Rename, ⇧Enter to Preview
响应
响应体
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| failed_list | Failed[] | 推送失败的事件列表，一次最多200个。 | |
| call_back_tag | String | user_add_org | 事件类型。 |
| event_time | Number | 事件的时间戳。 | |
| bpms_instance_change | Json | failed_list数组下每个单元的key，表示不同的回调tag。 | |
| errcode | Number | 0 | 返回码。 |
| errmsg | String | ok | 对返回码的文本描述内容。 |
| has_more | Boolean | false | 是否还有推送失败的变更事件，若为true，则表示还有未回调的事件。 |
| corpid | String | ding241f334c339e175b35c2f4657xxxx | 回调失败数据所属corpid。 |
| bpmsCallBackData | callbackData | roleLabelChange | Json |
bpmsCallBackData：审批回调
roleLabelChange：角色回调
callbackData：其他回调 |
响应体示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"errcode": 0,
"errmsg": "ok",
"failed_list": [
{
"user_add_org": {
"userid": [
"zhangsan"
],
"corpid": "ding241f334c339e175b35c2f4657xxxx"
},
"call_back_tag": "user_add_org",
"event_time": 1606126433000
},
{
"bpms_instance_change": {
"bpmsCallBackData": {},
"corpid": "ding241f334c339e175b35c2f4657xxxx"
},
"call_back_tag": "bpms_instance_change",
"event_time": 1606126433000
Enter to Rename, ⇧Enter to Preview
错误码
若调用该接口报错，可根据错误信息在全局错误码文档中查找解决方案。