获取推送失败的事件列表
GET
https://oapi.dingtalk.com/call_back/get_call_back_failed_result调用本获取推送失败的变更事件。钉钉服务器给回调地址推送数据时,有可能因为各种原因推送失败(例如网络异常),此时钉钉将保留此次变更事件。
重要
事件订阅推送失败,会进行重新推送,重试规则如下:
第几次重试 | 与上次重试时间间隔 |
---|---|
1 | 10秒 |
2 | 30秒 |
3 | 1分钟 |
4 | 2分钟 |
例如:事件第一次推送失败后,经过10秒,进行第一次重试,直至第4次重试失败后,可在3~5分钟内通过本接口获取推送失败的事件列表。
权限
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 默认开通,无需申请 | 调试 |
第三方企业应用 | 是 | 默认开通,无需申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。
企业内部应用可通过获取企业内部应用的access_token接口获取。
第三方企业应用可通过获取第三方应用授权企业的access_token接口获取。
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
errcode
integer
返回码。
errmsg
string
必需
对返回码的文本描述内容。
failed_list
array [object {5}]
必需
推送失败的事件列表,一次最多200个。
user_add_org
object
可选
call_back_tag
string
事件类型。
event_time
integer
事件的时间戳。
bpms_instance_change
object
可选
failed_list数组下每个单元的key,表示不同的回调tag。
label_conf_add
object
可选
has_more
boolean
必需
是否还有推送失败的变更事件,若为true,则表示还有未回调的事件。
示例
{
"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
},
{
"label_conf_add": {
"roleLabelChange": {},
"corpid": "ding241f334c339e175b35c2f4657xxxx"
},
"call_back_tag": "label_conf_add",
"event_time": 1606126433000
}
],
"has_more": false
}
修改于 8 个月前