# 获取推送失败的事件列表旧版SDK

![AI 智能摘要](https://gw.alicdn.com/imgextra/i4/O1CN01Zx4PED22rkUkmRe1L_!!6000000007174-2-tps-226-40.png)![>](https://gw.alicdn.com/imgextra/i2/O1CN01UwOv1C27lrTuGFj2D_!!6000000007838-2-tps-17-30.png)

更新于 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   |                                   | 具体回调失败的数据所属key。

-   **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

### **错误码**

若调用该接口报错，可根据错误信息在[全局错误码](https://open.dingtalk.com/document/development/server-api-error-codes-1#)文档中查找解决方案。